Coin/token info and specification for usage in ADAMANT apps.
Root directory includes:
\general\— Includes directories for each coin/token, in whichinfo.jsonstores their general descriptions and specifications.\blockchains\— Contains specific to blockchains information, which can override general specs. Tokens inside are grouped by blockchain as a separate folder.
Each blockchain in \blockchains\ includes info.json, which links to main coin in \general\:
{
"blockchain": "Ethereum", // Blockchain readable name
"type": "ERC20", // How an app should mark token blockchain
"mainCoin": "ethereum", // A coin containing parameters common to the blockchain
"fees": "ethereum" // Coin to pay fees in
}Navigate to \general\${mainCoin} to get explorer links, address regex and other shared for blockchain parameters.
Coin/token info stored in \general\${token_name} folders. Specific blockchain info in \blockchains\${blockchain_name} overrides it. For example:
{
"name": "Example Coin", // Readable coin name
"nameShort": "Example", // Optional. Readable coin short name
"website": "https://example.com", // Project website URL
"description": "Non existing coin", // Short description
"explorer": "https://explorer.example.com", // Optional. Explorer URL
"explorerTx": "https://explorer.example.com/tx/${ID}", // Optional. URL to get tx info
"explorerAddress": "https://explorer.example.com/address/${ID}", // Optional. URL to get address info
"explorerContract": "https://explorer.example.com/contract/${ID}", // Optional. URL to get contract info
"regexAddress": "^EC([0-9]{8,})$", // Optional. RegEx to validate coin address
"research": "https://research.binance.com/en/projects/${project}", // Optional. Research URL
"symbol": "SYM", // Coin ticker
"type": "coin", // "coin" or "token"
"decimals": 8, // Decimal places
"cryptoTransferDecimals": 8, // Max precision for tx
"minBalance": 0.00001, // Optional. Minimum acceptable amount for an address
"minTransferAmount": 0.00000546, // Optional. Minimum acceptable amount for tx
"fixedFee": 0.5, // Optional. Fixed transfer fee
// Optional. When the transfer fee is variable, but an app has not yet calculated it
"defaultFee": 0.00003153,
"qqPrefix": "exmpl", // Optional. QR code prefix for an address
"status": "active", // "active" or "disabled". Should the coin be processed
// Should an app itself create the coin or only use the info for the blockchain
"createCoin": true,
"defaultVisibility": true, // Optional. To show a coin by default, or hide it
"defaultOrdinalLevel": 0, // Optional. Default ordinal number in a wallet list. Coins with the same ordinal number are sorted alphabetically. Coins without an order are shown last, alphabetically
"consensus": "dPoS", // Optional. Blockchain consensus type
"blockTimeFixed": 5000, // Optional. Fixed block time in ms
"blockTimeAvg": 600000, // Optional. Average block time in ms
// Optional. Node links for API
"nodes": {
"list": [
{ "url": "https://node.example.com" },
{ "url": "http://0.0.0.0:36666" }, // It's possible to use IP:port URI
{
"url": "https://second-node.example.com",
"alt_ip": "0.0.0.1:36666" // Alternative way to connect if the domain of a node is censored
}
],
// Node health сheck information
"healthCheck": {
"normalUpdateInterval": 210000, // Regular node status update interval in ms
"crucialUpdateInterval": 30000, // Node status update interval when there are no active nodes, in ms
"onScreenUpdateInterval": 10000, // On the node screen, the status update interval in ms
"threshold": 3 // Permissible height difference between nodes
},
"minVersion": "1.0.0" // Optional. Minimal supported service API version
},
// Optional. Services related to a project
"services": {
"list": {
"infoService": [
{ "url": "https://info.example.com" },
{
"url": "https://second-service.example.com",
"alt_ip": "0.0.0.1:80" // Alternative way to connect if the domain of a service is censored
}
]
},
// Optional: Service health сheck information (If not filled here, information is retrieved from nodes.healthCheck)
"healthCheck": {
"normalUpdateInterval": 210000, // Regular service status update interval in ms
"crucialUpdateInterval": 30000, // Service status update interval when there are no active services, in ms
"onScreenUpdateInterval": 10000 // On the node screen, the status update interval in ms
},
"minVersion": "1.0.0", // Optional. Minimal supported service API version
},
// Optional. Additional project links
"links": [
{
"name": "github",
"url": "https://github.com/--example"
},
{
"name": "whitepaper",
"url": "https://example.com/whitepaper.pdf"
}
]
// Optional. Tor configuration if a project uses Tor
// It follows the same structure as the root properties
// Currently supported props are described below:
"tor": {
"website": "http://abc.onion",
"explorer": "http://xyz.onion",
"explorerTx": "http://xyz.onion/tx/${ID}",
"explorerAddress": "http://xyz.onion/address/${ID}",
"nodes": [/*...*/],
"services": {/*...*/},
"links": [/*...*/]
}
}The total cost of a transaction is the product of the gas limit and gas price:
ADAMANT apps estimate gas limit and gas price using web3 library. To make sure the Ethereum blockchain will include the tx, these estimates must be multiplied by reliabilityGasLimitPercent and reliabilityGasPricePercent.
If it’s not possible to get estimates, apps will use defaultGasLimit and defaultGasPriceGwei. When gas price is higher than warningGasPriceGwei, apps will show a note/warning.
These parameters are set inside general\ethereum\info.json and may be overridden by blockchains\ethereum\info.json and specific tokens.
Read AIP-12: Non-ADM crypto transfer messages to learn more about Tx statuses.
Statuses workflow: Pending (new or old tx) ⟶ Registered ⟶ Confirmed, Cancelled or Inconsistent.
To help apps with updating statuses, additional fields are introduced:
{
// ...
"txFetchInfo": {
// Interval between fetching Tx in ms when its current status is
"newPendingInterval": 10000, // "Pending" for new transactions
"oldPendingInterval": 3000, // "Pending" for old transactions
"registeredInterval": 40000, // "Registered"
// Attempts to fetch Tx when its current status is `Pending`
"newPendingAttempts": 20, // for new transactions
"oldPendingAttempts": 3 // for old transactions
},
/**
* Time in ms when difference between in-chat transfer and Tx timestamp considered
* as acceptable. Otherwise, an app should mark Tx as `Inconsistent`.
*/
"txConsistencyMaxTime": 60000
}Transaction considered as new or old depending on how much time passed from in-chat transfer.
const isNew = (admTransferTimestamp) =>
Date.now() - admTransferTimestamp <
newPendingTxFetchAttempts * newPendingTxFetchInterval;Coin icons/images files are stored \general\${token_name}\images folders.
Required:
-
icon.svg— Vector image file -
icon.vue— Vector image vue template for PWA -
${token_name}_wallet.png— @x1 (55px) resolution for iOS app -
${token_name}[email protected]— same, @x2 resolution -
${token_name}[email protected]— same, @x3 resolution
Optional:
-
${token_name}_wallet_dark.png— @x1 (55px) resolution for iOS app, dark icon -
${token_name}[email protected]— same, @x2 resolution -
${token_name}[email protected]— same, @x3 resolution -
${token_name}_notification.png— @x1 (55px) resolution for iOS push notifications -
${token_name}[email protected]— same, @x2 resolution -
${token_name}[email protected]— same, @x3 resolution -
${token_name}_wallet_row.png— @x1 (21px) resolution for iOS app for private key screen -
${token_name}[email protected]— same, @x2 resolution -
${token_name}[email protected]— same, @x3 resolution
If there will be no optional icons, apps will take regular _wallet icons.
Please have a look at the CONTRIBUTING.md.