FIfireblocks
Tokenization

Issue a token on one or more blockchains

Facilitates the creation of a new token on one or more blockchains.

post/tokenization/multichain/tokens

Request

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

vaultAccountIdstring required

The id of the vault account that initiated the request to issue the token

saltstring

The salt to calculate the deterministic address. Must be a number between 0 and 2^256 -1, for it to fit in the bytes32 parameter.

chainsstring[] required

The base asset identifiers of the blockchains (legacyId) to calculate deterministic addresses

displayNamestring
useGaslessboolean

Indicates whether the token should be created in a gasless manner, utilizing the ERC-2771 standard. When set to true, the transaction will be relayed by a designated relayer. The workspace must be configured to use Fireblocks gasless relay.

feestring

Max fee amount for the write function transaction. interchangeable with the 'feeLevel' field

feeLevel'LOW' | 'MEDIUM' | 'HIGH'

Fee level for the write function transaction. interchangeable with the 'fee' field

Example request

{
  "vaultAccountId": "0",
  "createParams": {
    "contractId": "b70701f4-d7b1-4795-a8ee-b09cdb5b850d",
    "deployFunctionParams": [
      {
        "internalType": "string",
        "name": "name",
        "type": "string",
        "value": "name"
      },
      {
        "internalType": "string",
        "name": "symbol",
        "type": "string",
        "value": "symbol"
      },
      {
        "components": [
          {
            "internalType": "bool",
            "name": "_isMintable",
            "type": "bool"
          }
        ],
        "internalType": "struct MyStruct",
        "name": "customConfigProps",
        "type": "tuple",
        "value": [
          {
            "internalType": "bool",
            "name": "_isMintable",
            "type": "bool",
            "value": false
          }
        ]
      }
    ]
  },
  "salt": "123456789",
  "chains": [
    "ETH",
    "POLYGON"
  ],
  "fee": "2000",
  "feeLevel": "MEDIUM"
}

Response

Tokens were created successfully

idstring required

The token link id

status'PENDING' | 'COMPLETED' required

The token status

type'FUNGIBLE_TOKEN' | 'NON_FUNGIBLE_TOKEN' | 'TOKEN_UTILITY' | 'TOKEN_EXTENSION'

The type of token

refIdstring

The Fireblocks' reference id

displayNamestring

The token display name. If was not provided, would be taken from the contract template

Example response

[
  {
    "id": "fbfbfbfb-fbfb-fbfb-fbfb-fbfbfbfbfbfb",
    "status": "COMPLETED",
    "type": "NON_FUNGIBLE_TOKEN",
    "refId": "BQ5R_MY_TOKEN",
    "displayName": "My Simple ERC20 Token",
    "tokenMetadata": {
      "assetId": "BQ5R_MY_TOKEN",
      "name": "MyToken",
      "symbol": "MYT",
      "networkProtocol": "ETH",
      "totalSupply": "1000000000000000",
      "type": "ERC20",
      "contractAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "issuerAddress": "rGyXjc5d7s17vvt3NtKKascvJrnSxV21kQ",
      "testnet": true,
      "blockchain": "ETH_TEST5",
      "decimals": 18,
      "vaultAccountId": "0"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.