Connect as an Exchange

Exchanges must connect to the Pangea network to transfer and sell LEOS and other tokens. This guide provides the steps to set up an account that can act as a LEOS token custodian for token sales and exchange listing management.

You can connect using the official Antelope CLI tool called "cleos", or the Tonomy Javascript SDK with command line using nodejs or by integrating the Javascript library into your tools.

Install tools

Install the official Antelope node CLI "cleos" binary on Ubuntu 22.04. Please use a different release asset for other operating systems. Check the documentation for more details.

wget https://github.com/AntelopeIO/leap/releases/download/v4.0.6/leap_4.0.6-ubuntu22.04_amd64.deb
sudo apt install ./leap_4.0.6-ubuntu22.04_amd64.deb
rm ./leap_4.0.6-ubuntu22.04_amd64.deb

# create an alias that connects to the correct API
alias cleospangea="cleos -u https://blockchain-api.pangea.web4.world/"

# check working
cleospangea get info

Install the Pangea Javascript CLI on Ubuntu 22.04 with Nodejs 22.3.0. Check the documentation for more details.

git clone https://github.com/Tonomy-Foundation/Tonomy-ID-SDK
cd Tonomy-ID-SDK

corepack enable
yarn
export NODE_ENV=production
yarn run build:cli

# check working
yarn run cli --help

Compatibility

The Tonomy SDK requires nodejs v20+

Notes for yarn v2+

If using yarn v2+ then you will need to also add the following to your package.json file.

"resolutions": {
    "jsonld": "link:./node_modules/@digitalcredentials/jsonld"
  },

npm i @tonomy/tonomy-id-sdk
# or
yarn add @tonomy/tonomy-id-sdk

Compatibility

The Tonomy SDK requires nodejs v20+

Notes for yarn v2+

If using yarn v2+ then you will need to also add the following to your package.json file.

"resolutions": {
    "jsonld": "link:./node_modules/@digitalcredentials/jsonld"
  },

Step 1: Create keys

Create 2x keys to manage your account on Pangea Blockchain. One key is treated as high security and used for recovery called the "owner" key, while the other is used for day-to-day operation and can be replaced by the recovery key (if compromised) called the "active" key.

cleospangea create key --to-console

yarn run cli keys create

import { setSettings, generateRandomKeyPair } from '@tonomy/tonomy-id-sdk';

setSettings({ blockchainUrl: "https://blockchain-api.pangea.web4.world" });

const keyPair = generateRandomKeyPair();

console.log('Public key: ', keyPair.publicKey.toString());
console.log('Private key: ', keyPair.privateKey.toString());

Store both keys in secure storage.

Step 2: Create an account

Send the following information to the Tonomy Foundation through a secure pre-established channel:

Choose your account name which is a 12-character [a-z1-5.] word e.g. binancelists
Choose your username which is an English character lower case word with 2+ characters e.g. @binanceexchange
The name, domain name (website) and logo to use for your exchange
The public key of your "owner" key. Don't send your private key.
The public key of your "active" key. Don't send your private key.

Step 3: Get some LEOS for allocation to investors

As per your LEOS token issuance contract with the Tonomy Foundation, ensure that after your account is created it is allocated the correct amount of LEOS. You can look at your account and its tokens on the Pangea block explorer:

https://explorer.pangea.web4.world

Step 4: Collect user's Pangea account

You will need to get the user to create a Pangea account and collect their username and account name. This is so that you know who to send the LEOS to.

Tell your users to create a Pangea account by downloading and creating a new account on the United Citizens Wallet: https://pangea.web4.world/united-citizens-wallet
Set up the single-sign-on login to your exchange using the Pangea Single Sign-On documentation.
After the user has logged in, you can get their account name from the user object that is provided and verified on the /callback page, as shown in the Pangea Usage and signing data documentation. const accountName = await user.getAccountName().toString();

Step 5: Allocate vested LEOS or transfer LEOS

Info: The quantity must be sent with 6 decimal places in the following format "10.000000 LEOS"

Allocate vested LEOS

Vested LEOS should be allocated during the private sale (seed) rounds.

cleospangea wallet create --to-console
# import your active key:
cleospangea wallet import

SENDER=binancelists
RECIPIENT=pegcnjcnnaqd
AMOUNT="10.000000 LEOS"
# use category 8 for seed round 1 "early bird, and category 9 for seed round 2 "last chance"
CATEGORY=8

cleospangea push action vesting.tmy assigntokens "{\"sender\":\"${SENDER}\",\"holder\":\"${RECIPIENT}\",\"amount\":\"${AMOUNT}\",\"category\":${CATEGORY}" -p "${SENDER}@active"

export NODE_ENV=production
# use your active private key:
export SIGNING_KEY=PVT_K1_2jFrRPkFNLiZiqLb9QjWxec3Xr7o4Jf4TShxCFq1R1a7e71iSV

SENDER=binancelists
RECIPIENT=pegcnjcnnaqd
AMOUNT="10.000000 LEOS"
# use category 8 for seed round 1 "early bird, and category 9 for seed round 2 "last chance"
CATEGORY=8

yarn run cli vesting assign "${SENDER}" "${RECIPIENT}" "${AMOUNT}" "${CATEGORY}"

import { setSettings, VestingContract } from '@tonomy/tonomy-id-sdk';
import { PrivateKey } from '@wharfkit/antelope';

setSettings({ blockchainUrl: "https://blockchain-api.pangea.web4.world" });

const vestingContract = VestingContract.Instance;
const privateKey = PrivateKey.from('PVT_K1_2jFrRPkFNLiZiqLb9QjWxec3Xr7o4Jf4TShxCFq1R1a7e71iSV');
const signer = createSigner(privateKey);

const sender = "binancelists"
const recipient = "pegcnjcnnaqd"
const amount = "10.000000 LEOS"
// use category 8 for seed round 1 "early bird, and category 9 for seed round 2 "last chance"
const category = 8

await vestingContract.assignTokens(sender, recipient, amount, category, signer);

Transfer (unvested) LEOS

LEOS transfers can be used during the public sale or after to send users unvested LEOS.

cleospangea wallet create --to-console
# import your active key:
cleospangea wallet import

SENDER=eosusa
RECIPIENT=pegcnjcnnaqd
AMOUNT="10.000000 LEOS"
MEMO="my transfer memo"

cleospangea transfer "${SENDER}" "${RECIPIENT}" "${AMOUNT}" "${MEMO}" -p "${SENDER}@active"

export NODE_ENV=production
# use your active private key:
export SIGNING_KEY=PVT_K1_2jFrRPkFNLiZiqLb9QjWxec3Xr7o4Jf4TShxCFq1R1a7e71iSV

SENDER=eosusa
RECIPIENT=pegcnjcnnaqd
AMOUNT="10.000000 LEOS"

yarn run cli transfer "${SENDER}" "${RECIPIENT}" "${AMOUNT}"

import { setSettings, EosioTokenContract } from '@tonomy/tonomy-id-sdk';
import { PrivateKey } from '@wharfkit/antelope';

setSettings({ blockchainUrl: "https://blockchain-api.pangea.web4.world" });

const tokenContract = EosioTokenContract .Instance;
const privateKey = PrivateKey.from('PVT_K1_2jFrRPkFNLiZiqLb9QjWxec3Xr7o4Jf4TShxCFq1R1a7e71iSV');
const signer = createSigner(privateKey);

const senderi= "eosusa"
const recipient = "pegcnjcnnaqd"
const amount = "10.000000 LEOS"

await tokenContract.transfer(sender, recipient, amount, signer);

Troubleshooting

Antelope documentation: https://docs.eosnetwork.com/docs/latest/quick-start/introduction

Antelope telegram group: https://t.me/antelopedevs

Pangea telegram group: https://t.me/pangea_web4

PreviousTroubleshooting NextRun Tonomy Gov OS

Last updated 9 hours ago