Map Public Address

post https://test.fio.eosusa.io/v1/chain/add_pub_address

This call maps the supplied public address on the supplied blockchain for the supplied token to the supplied FIO Handle, so that it can be returned using /get_pub_address.

You may pass up to 5 public addresses in a single call. A maximum of 200 public addresses may be mapped to a FIO Handle.

By specifying "*" for the token code you can map all tokens for that chain to the same address.

The actor must own the supplied FIO Handle.

See FIO Handle Mapping Guide form more information.

If you choose to modify the mapping for chain_code=FIO & token_code=FIO, please first read Setting different encrypt key.

🚧
This action has to be serialized and signed!
Please note that this action has to be be serialized and signed before it's sent to the blockchain. The request object below only represents the action specific parameters and action specific response. See Write Transactions Guide for more information.

Actions parameters

account: fio.address
name: addaddress

SDK Sandbox Example

Body Params

fio_address

string

required

length between 3 and 64

FIO Handle. It used to be called FIO Address, so you will still see it referred to as such.

public_addresses

array of objects

required

length between 1 and 5

Maximum of 5 token codes can be mapped to single FIO Handle at any one time.

public_addresses*

chain_code

string

required

length between 1 and 10

See Chain and token code standard

token_code

string

required

length between 1 and 10

See Chain and token code standard

public_address

string

required

length between 1 and 128

Public address for chain/token code.

Integrated Address

If the blockchain supports it, an integrated address may be passed in just like standard public address. The FIO protocol does not perform validation on the passed string.

URI Scheme

FIO Protocol will support formatting of public addresses using URI where certain attributes are appended to the public address following a '?' and delimited with '&'. To allow inter-wallet operability, the following standardized parameters will be supported in official FIO Protocol SDKs.

Parameters

dt - Ripple
memo - Any - use as generic memo field
memo_id - Stellar
memo_text - Stellar
memo_hash - Stellar
memo_return - Stellar
payment_id - Monero

See FIO Handle Mapping Guide for more information.

max_fee

integer

required

Defaults to 10000000000000

Maximum amount of SUFs the user is willing to pay for on-chain fee. Should be preceded by /get_fee for correct value.

Alternatively, you can set this number to a very high value, e.g. 10000000000000, since the user will only be charged the actual amount of the fee.

See

tpid

string

required

length between 3 and 64

Defaults to vitalik@safu

FIO Handle of the wallet which generated this transaction. This FIO Handle will be paid 10% of the fee collected. Set to empty if not known.

See Transaction Provider ID (TPID) Guide for more information.

actor

string

required

Represents FIO Account which will execute the action. In most cases this is the hashed FIO Public Key.

xxxxxxxxxx
// Register FIO Handle Action
var action = 'addaddress'
var contract = 'fio.address'
​
const {FIOSDK} = require('@fioprotocol/fiosdk')
var fetch = require('node-fetch')
const fetchJson = async (uri, opts = {}) => {
  return fetch(uri, opts)
}
​
// EDIT this section then type node addaddress.js in Terminal to run
// API endpoint, see https://github.com/fioprotocol/fio.mainnet for complete list
const apiNode = 'https://fiotestnet.blockpane.com/v1/' 
// FIO Chain Testnet private key. Get one from http://monitor.testnet.fioprotocol.io:3000/#createKey
// and then add tokens via faucet: http://monitor.testnet.fioprotocol.io:3000/#faucet
const privateKey = '5K9du1JcEVNyBZKU6Uc9bSihgUzmMvGUxPDRwyxVmo9Xuh2NNW3'
const publicKey = FIOSDK.derivedPublicKey(privateKey).publicKey
const account = FIOSDK.accountHash(publicKey).accountnm
// Action parameters
var actionData = 
{
  fio_address: 'user10006@regtest',
  public_addresses: [
    {
      chain_code: 'ETH',
      token_code: 'ETH',
      public_address: '0xab5801a7d398351b8be11c439e05c5b3259aec9b'
    }    
    ],