Il protocollo Sidechain di Scrypta è descritto nella sezione apposita. Vediamo qui come interagire con le Sidechain attraverso gli enpoint dell’IdANode.
Questo endpoint serve a creare una sidechain, i processi interni sono descritti nel capitolo “Emissione” della sezione dedicata. Consigliamo la creazione di un nuovo indirizzo personale direttamente da manent web, così da poter gestire i token via interfaccia grafica. E’ richiesta inoltre 1 LYRA nel balance dell’indirizzo, altrimenti la creazione non andrà a buon fine.
Ecco i campi da inviare per creare una nuova Sidechain:
- dapp_address: l’indirizzo che diventerà l’owner della sidechain
- private_key: Chiave privata dell’indirizzo dell’owner
- pubkey: chiave pubblica dell’indirizzo dell’owner
- version: la versione del protocollo, al momento è
1
- name: nome descrittivo della sidechain
- symbol: ticker alfanumerico della sidechain
- supply: l’ammontare di token da creare
- decimals: il numero di cifre con cui è possibile dividere il token
- burnable: può essere
true
ofalse
e determina se il token può essere inviato o meno all'indirizzo del trustlink per effettuare un burn di token. - reissuable: può essere
true
ofalse
e determina se il token è a supply fissa oppure è possibile riemetterlo in un secondo momento. - permissioned: può essere
true
ofalse
e determina se la sidechain è permissioned oppure no, se impostato sutrue
si dovranno autorizzare tutti gli utenti. - extendable (WIP): può essere
true
ofalse
e determina se il token è esteso da uno smart contract oppure no (ancora in work in progress, non usare).
Se tutto è andato per il verso giusto, la nuova sidechain verrà visualizzata qui: https://sidechain.scryptachain.org e sarà anche visibile il balance disponibile.Questo endpoint serve a riemettere token all’interno di una sidechain già esistente. Questo processo può essere effettuato solo dall’owner della sidechain e solamente se è stata marcata come reissuable
.
Ecco i campi da inviare per riemettere token:
- dapp_address: L’indirizzo dell’owner
- sidechain_address: L’indirizzo della sidechain
- private_key: La private key dell’owner
- pubkey: La pubkey dell’owner
- supply: La quantità di token che volete riemettere
La risposta conterrà le informazioni necessarie a verificare che tutto sia andato bene e successivamente vedrete nella lista dei vostri unspent questa nuova transazione di reissue.Tramite questo enpoint è possibile inviare i token in proprio possesso ad un altro indirizzo. Per farlo è necessario inviare i seguenti campi:
- from: l’indirizzo da cui volete mandare i token
- private_key: la chiave privata dell’indirizzo che invia i token
- pubkey: la chiave pubblica dell’indirizzo che invia i token
- sidechain_address: l’indirizzo della sidechain
- to: l’indirizzo che riceverà i token
- amount: l’ammontare da inviare, si ricorda di rispettare la divisione dei decimali in quanto l’IdANode arrotonda la cifra per assicurarsi dell’esattezza edell’operazion; uneventuale diffr comporta l’invio di un ammontare arrotondato, quindi diverso da quello richiesto.
Facile notare le ultime due proprietà dell’oggetto sono consensus
e reliability
ovvero ci danno il numero di nodi collegati che riportano lo stesso stato e l'affidabilità del nodo stesso.
La libreria @scrypta/core
ritiene inaffidabili i nodi che hanno un valore inferiore a 50 collegandosi di conseguenza ad un altro nodo automaticamente.