Skip to content

Latest commit

 

History

History
93 lines (78 loc) · 3.26 KB

utxo_retrieve.md

File metadata and controls

93 lines (78 loc) · 3.26 KB
Description
Tutorial on how to retrieve output coins V1.

Retrieve Output Coins

In this tutorial, we only examine the way to get our output coins V1. The next post will be dedicated for output coins V2. As we have seen in the previous tutorial, all output coins V1 of a user (whether spent or unspent) have the same public key, which is the public key of the user. Therefore, it is easy to store and retrieve these coins with just the user's public key. We now present two ways a user can retrieve all of his output coins V1.

  • Via JSON-RPC
{
	"jsonrpc": "1.0",
	"method": "listoutputcoins",
	"params": [
			0,
			9999999,
			[
				{
				"PaymentAddress": "12sm5BLDevJsUbevkJd7eaU9zAiuNixEeUsNnYddnsqEYTrcFMfE7aSS2J6mK3GeHbdT7LMm4VcRETaJCRzzU8xKKa1Tn2t9XcGiqWSDpG7jewQkDeRDY3czMHVEgwWGfUWMvkd2pWr1QpMw1i4s",
				"ReadonlyKey" : "13hZcYDRTsydn5WvfjbraPno7XK1wBPg6ATaYbRYeh6tfr5wgLhma1545K8TPDCLrS4G9GF4AGRzwP7sd4vPvv3XP2WRvAt8Y5YUJcD",
				}
			],
		"0000000000000000000000000000000000000000000000000000000000000004"
		],
	"id": 1
}

The first parameter is deprecated, but it is still needed for old full-node. So you better do not change it. The second parameter denotes the upper shard height you wish to retrieve output coins. PaymentAddress is required to get all TXOs of the user while the ReadonlyKey is optional, which is used to decrypt these TXOs. For better privacy, we recommend you leave it empty.

  • Via the go-sdk

First, create a new client instance.

client, err := incclient.NewTestNet1Client()
if err != nil {
	log.Fatal(err)
}

Then, create a new OutCoinKey instance from your private key. The OutCoinKey consists of a payment address, a readonly key, and a privateOTA key.

// create a new OutCoinKey
outCoinKey, err := incclient.NewOutCoinKeyFromPrivateKey(privateKey)
if err != nil {
	log.Fatal(err)
}
outCoinKey.SetReadonlyKey("") // call this if you do not want the remote full-node to decrypt your coin

Example

utxo.go

package main

import (
	"fmt"
	"log"

	"github.com/incognitochain/go-incognito-sdk-v2/common/base58"

	"github.com/incognitochain/go-incognito-sdk-v2/incclient"
)

func main() {
	// create a new client
	client, err := incclient.NewTestNet1Client()
	if err != nil {
		log.Fatal(err)
	}

	privateKey := "112t8rneWAhErTC8YUFTnfcKHvB1x6uAVdehy1S8GP2psgqDxK3RHouUcd69fz88oAL9XuMyQ8mBY5FmmGJdcyrpwXjWBXRpoWwgJXjsxi4j"
	tokenID := "0000000000000000000000000000000000000000000000000000000000000004"

	// create a new OutCoinKey
	outCoinKey, err := incclient.NewOutCoinKeyFromPrivateKey(privateKey)
	if err != nil {
		log.Fatal(err)
	}
	outCoinKey.SetReadonlyKey("") // call this if you do not want the remote full-node to decrypt your coin

	outCoinsV1, idxList, err := client.GetOutputCoins(outCoinKey, tokenID, 0)
	for i, outCoin := range outCoinsV1 {
		fmt.Printf("idx: %v, version: %v, isEncrypted: %v, publicKey: %v\n", idxList[i].Uint64(),
			outCoin.GetVersion(), outCoin.IsEncrypted(), base58.Base58Check{}.Encode(outCoin.GetPublicKey().ToBytesS(), 0x00))
	}

}

Pretty simple, right? Now, let's move on to output coins V2.

Return to the table of contents.