Update a blockchain - Fireblocks Developer Docs

PUT

blockchain_link

blockchains

{blockchainId}

TypeScript

const response: Promise<FireblocksResponse<UpdateBlockchainResponse>> = fireblocks.blockchainLinkBeta.updateBlockchainLinkChain(blockchainLinkBetaApiUpdateBlockchainLinkChainRequest);

CompletableFuture<ApiResponse<UpdateBlockchainResponse>> response = fireblocks.blockchainLinkBeta().updateBlockchainLinkChain(blockchainDeclaredProperties, blockchainId, idempotencyKey);

response = fireblocks.blockchain_link_beta.update_blockchain_link_chain(blockchain_declared_properties, blockchain_id, idempotency_key);

curl --request PUT \
  --url https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainName": "Ethereum",
  "chainId": 1,
  "symbolName": "ETH",
  "rpcUrls": [
    "https://rpc.example.com"
  ],
  "environmentType": "ENVIRONMENT_TYPE_MAINNET",
  "decimals": 18,
  "blockExplorerUrl": "https://etherscan.io",
  "blockExplorerTransactionPath": "/tx",
  "blockExplorerAddressPath": "/address",
  "networkId": 1,
  "hasFee": true,
  "isPoa": false,
  "hasLayeredFee": false,
  "nodeType": "NODE_TYPE_CORE_GETH",
  "transactionFormat": 0,
  "baseAssetTenantIds": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "explorerApiUrl": "https://api.etherscan.io",
  "explorerApiKey": "my-explorer-api-key",
  "isTraceEnabled": false
}
'

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    chainName: 'Ethereum',
    chainId: 1,
    symbolName: 'ETH',
    rpcUrls: ['https://rpc.example.com'],
    environmentType: 'ENVIRONMENT_TYPE_MAINNET',
    decimals: 18,
    blockExplorerUrl: 'https://etherscan.io',
    blockExplorerTransactionPath: '/tx',
    blockExplorerAddressPath: '/address',
    networkId: 1,
    hasFee: true,
    isPoa: false,
    hasLayeredFee: false,
    nodeType: 'NODE_TYPE_CORE_GETH',
    transactionFormat: 0,
    baseAssetTenantIds: ['f47ac10b-58cc-4372-a567-0e02b2c3d479'],
    explorerApiUrl: 'https://api.etherscan.io',
    explorerApiKey: 'my-explorer-api-key',
    isTraceEnabled: false
  })
};

fetch('https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'chainName' => 'Ethereum',
    'chainId' => 1,
    'symbolName' => 'ETH',
    'rpcUrls' => [
        'https://rpc.example.com'
    ],
    'environmentType' => 'ENVIRONMENT_TYPE_MAINNET',
    'decimals' => 18,
    'blockExplorerUrl' => 'https://etherscan.io',
    'blockExplorerTransactionPath' => '/tx',
    'blockExplorerAddressPath' => '/address',
    'networkId' => 1,
    'hasFee' => true,
    'isPoa' => false,
    'hasLayeredFee' => false,
    'nodeType' => 'NODE_TYPE_CORE_GETH',
    'transactionFormat' => 0,
    'baseAssetTenantIds' => [
        'f47ac10b-58cc-4372-a567-0e02b2c3d479'
    ],
    'explorerApiUrl' => 'https://api.etherscan.io',
    'explorerApiKey' => 'my-explorer-api-key',
    'isTraceEnabled' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}"

	payload := strings.NewReader("{\n  \"chainName\": \"Ethereum\",\n  \"chainId\": 1,\n  \"symbolName\": \"ETH\",\n  \"rpcUrls\": [\n    \"https://rpc.example.com\"\n  ],\n  \"environmentType\": \"ENVIRONMENT_TYPE_MAINNET\",\n  \"decimals\": 18,\n  \"blockExplorerUrl\": \"https://etherscan.io\",\n  \"blockExplorerTransactionPath\": \"/tx\",\n  \"blockExplorerAddressPath\": \"/address\",\n  \"networkId\": 1,\n  \"hasFee\": true,\n  \"isPoa\": false,\n  \"hasLayeredFee\": false,\n  \"nodeType\": \"NODE_TYPE_CORE_GETH\",\n  \"transactionFormat\": 0,\n  \"baseAssetTenantIds\": [\n    \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n  ],\n  \"explorerApiUrl\": \"https://api.etherscan.io\",\n  \"explorerApiKey\": \"my-explorer-api-key\",\n  \"isTraceEnabled\": false\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chainName\": \"Ethereum\",\n  \"chainId\": 1,\n  \"symbolName\": \"ETH\",\n  \"rpcUrls\": [\n    \"https://rpc.example.com\"\n  ],\n  \"environmentType\": \"ENVIRONMENT_TYPE_MAINNET\",\n  \"decimals\": 18,\n  \"blockExplorerUrl\": \"https://etherscan.io\",\n  \"blockExplorerTransactionPath\": \"/tx\",\n  \"blockExplorerAddressPath\": \"/address\",\n  \"networkId\": 1,\n  \"hasFee\": true,\n  \"isPoa\": false,\n  \"hasLayeredFee\": false,\n  \"nodeType\": \"NODE_TYPE_CORE_GETH\",\n  \"transactionFormat\": 0,\n  \"baseAssetTenantIds\": [\n    \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n  ],\n  \"explorerApiUrl\": \"https://api.etherscan.io\",\n  \"explorerApiKey\": \"my-explorer-api-key\",\n  \"isTraceEnabled\": false\n}"

response = http.request(request)
puts response.read_body

{
  "blockchain": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "blockchainState": "BLOCKCHAIN_STATE_ACTIVATED",
    "declaredProperties": {
      "chainName": "Ethereum",
      "chainId": 1,
      "symbolName": "ETH",
      "rpcUrls": [
        "https://rpc.example.com"
      ],
      "environmentType": "ENVIRONMENT_TYPE_MAINNET",
      "decimals": 18,
      "blockExplorerUrl": "https://etherscan.io",
      "blockExplorerTransactionPath": "/tx",
      "blockExplorerAddressPath": "/address",
      "networkId": 1,
      "hasFee": true,
      "isPoa": false,
      "hasLayeredFee": false,
      "nodeType": "NODE_TYPE_CORE_GETH",
      "transactionFormat": 0,
      "baseAssetTenantIds": [
        "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      ],
      "explorerApiUrl": "https://api.etherscan.io",
      "explorerApiKey": "my-explorer-api-key",
      "isTraceEnabled": false,
      "rpcAuth": {
        "type": "RPC_AUTH_BASIC",
        "username": "rpc_user",
        "password": "my-password",
        "token": "my-bearer-token",
        "headerName": "X-Custom-Auth",
        "headerValue": "my-header-value"
      }
    },
    "createdAtUtc": 1700000000000,
    "updatedAtUtc": 1700000000000,
    "validationFailureReasons": [
      "RPC endpoint unreachable"
    ],
    "validationSessionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "validationStatus": "VALIDATION_STATUS_SUCCEEDED",
    "validationCreatedAtUtc": 1700000000000,
    "validationUpdatedAtUtc": 1700000000000,
    "validationCompletedAtUtc": 1700000000000,
    "failedStep": "FAILED_STEP_CONFIGURATION"
  },
  "message": "Blockchain updated successfully"
}

{
  "message": "<string>",
  "code": 123
}

Headers

Idempotency-Key

string

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.

Path Parameters

blockchainId

string

required

ID of the blockchain to update (supplied as a path parameter).

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Body

application/json

Declared properties for blockchain configuration (create/update API and response) Only the fields sent by the API and returned in list/create/update responses.

chainName

string

required

Human-readable name of the blockchain.

Example:

"Ethereum"

chainId

number

required

EVM chain ID of the blockchain.

Example:

1

symbolName

string

required

Native asset symbol of the blockchain.

Example:

"ETH"

rpcUrls

string[]

required

RPC endpoint URLs for the blockchain.

Required array length: 1 element

Example:

["https://rpc.example.com"]

environmentType

enum<string>

required

Network environment (mainnet or testnet).

Available options:

ENVIRONMENT_TYPE_MAINNET,

ENVIRONMENT_TYPE_TESTNET

Example:

"ENVIRONMENT_TYPE_MAINNET"

decimals

number

Number of decimals for the native asset.

Example:

18

blockExplorerUrl

string

Base URL of the block explorer.

Example:

"https://etherscan.io"

blockExplorerTransactionPath

string

Path template for a transaction on the block explorer.

Example:

"/tx"

blockExplorerAddressPath

string

Path template for an address on the block explorer.

Example:

"/address"

networkId

number

EVM network ID of the blockchain.

Example:

1

hasFee

boolean

Whether the blockchain charges transaction fees.

Example:

true

isPoa

boolean

Whether the blockchain uses proof-of-authority consensus.

Example:

false

hasLayeredFee

boolean

Whether the blockchain uses a layered fee model.

Example:

false

nodeType

enum<string>

Node client type for the blockchain.

Available options:

NODE_TYPE_CORE_GETH,

NODE_TYPE_FANTOM,

NODE_TYPE_ERIGON,

NODE_TYPE_PARITY,

NODE_TYPE_BESU

Example:

"NODE_TYPE_CORE_GETH"

transactionFormat

number

Transaction format identifier.

Example:

0

baseAssetTenantIds

string[]

Tenant IDs that share this base asset.

Example:

["f47ac10b-58cc-4372-a567-0e02b2c3d479"]

explorerApiUrl

string

Block explorer API base URL.

Example:

"https://api.etherscan.io"

explorerApiKey

string

API key for the block explorer API.

Example:

"my-explorer-api-key"

isTraceEnabled

boolean

Whether trace/debug RPC methods are enabled.

Example:

false

rpcAuth

object

Discriminated RPC auth payload. Sent on create/update so backend can distinguish "no auth" from "field unchanged" on PUT updates. Credential values are stored inside declaredProperties and fetched at activation time; they are deliberately not carried through workflow context.

Show child attributes

Response

blockchain

object

required

Blockchain entity

Show child attributes

message

string

required

Human-readable result message.

Example:

"Blockchain updated successfully"

Delete a blockchainPermanently removes a blockchain identified by its ID. The blockchain must not be in an active lifecycle state.

⌘I

TypeScript

const response: Promise<FireblocksResponse<UpdateBlockchainResponse>> = fireblocks.blockchainLinkBeta.updateBlockchainLinkChain(blockchainLinkBetaApiUpdateBlockchainLinkChainRequest);

CompletableFuture<ApiResponse<UpdateBlockchainResponse>> response = fireblocks.blockchainLinkBeta().updateBlockchainLinkChain(blockchainDeclaredProperties, blockchainId, idempotencyKey);

response = fireblocks.blockchain_link_beta.update_blockchain_link_chain(blockchain_declared_properties, blockchain_id, idempotency_key);

curl --request PUT \
  --url https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainName": "Ethereum",
  "chainId": 1,
  "symbolName": "ETH",
  "rpcUrls": [
    "https://rpc.example.com"
  ],
  "environmentType": "ENVIRONMENT_TYPE_MAINNET",
  "decimals": 18,
  "blockExplorerUrl": "https://etherscan.io",
  "blockExplorerTransactionPath": "/tx",
  "blockExplorerAddressPath": "/address",
  "networkId": 1,
  "hasFee": true,
  "isPoa": false,
  "hasLayeredFee": false,
  "nodeType": "NODE_TYPE_CORE_GETH",
  "transactionFormat": 0,
  "baseAssetTenantIds": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "explorerApiUrl": "https://api.etherscan.io",
  "explorerApiKey": "my-explorer-api-key",
  "isTraceEnabled": false
}
'

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    chainName: 'Ethereum',
    chainId: 1,
    symbolName: 'ETH',
    rpcUrls: ['https://rpc.example.com'],
    environmentType: 'ENVIRONMENT_TYPE_MAINNET',
    decimals: 18,
    blockExplorerUrl: 'https://etherscan.io',
    blockExplorerTransactionPath: '/tx',
    blockExplorerAddressPath: '/address',
    networkId: 1,
    hasFee: true,
    isPoa: false,
    hasLayeredFee: false,
    nodeType: 'NODE_TYPE_CORE_GETH',
    transactionFormat: 0,
    baseAssetTenantIds: ['f47ac10b-58cc-4372-a567-0e02b2c3d479'],
    explorerApiUrl: 'https://api.etherscan.io',
    explorerApiKey: 'my-explorer-api-key',
    isTraceEnabled: false
  })
};

fetch('https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'chainName' => 'Ethereum',
    'chainId' => 1,
    'symbolName' => 'ETH',
    'rpcUrls' => [
        'https://rpc.example.com'
    ],
    'environmentType' => 'ENVIRONMENT_TYPE_MAINNET',
    'decimals' => 18,
    'blockExplorerUrl' => 'https://etherscan.io',
    'blockExplorerTransactionPath' => '/tx',
    'blockExplorerAddressPath' => '/address',
    'networkId' => 1,
    'hasFee' => true,
    'isPoa' => false,
    'hasLayeredFee' => false,
    'nodeType' => 'NODE_TYPE_CORE_GETH',
    'transactionFormat' => 0,
    'baseAssetTenantIds' => [
        'f47ac10b-58cc-4372-a567-0e02b2c3d479'
    ],
    'explorerApiUrl' => 'https://api.etherscan.io',
    'explorerApiKey' => 'my-explorer-api-key',
    'isTraceEnabled' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}"

	payload := strings.NewReader("{\n  \"chainName\": \"Ethereum\",\n  \"chainId\": 1,\n  \"symbolName\": \"ETH\",\n  \"rpcUrls\": [\n    \"https://rpc.example.com\"\n  ],\n  \"environmentType\": \"ENVIRONMENT_TYPE_MAINNET\",\n  \"decimals\": 18,\n  \"blockExplorerUrl\": \"https://etherscan.io\",\n  \"blockExplorerTransactionPath\": \"/tx\",\n  \"blockExplorerAddressPath\": \"/address\",\n  \"networkId\": 1,\n  \"hasFee\": true,\n  \"isPoa\": false,\n  \"hasLayeredFee\": false,\n  \"nodeType\": \"NODE_TYPE_CORE_GETH\",\n  \"transactionFormat\": 0,\n  \"baseAssetTenantIds\": [\n    \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n  ],\n  \"explorerApiUrl\": \"https://api.etherscan.io\",\n  \"explorerApiKey\": \"my-explorer-api-key\",\n  \"isTraceEnabled\": false\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/blockchain_link/blockchains/{blockchainId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chainName\": \"Ethereum\",\n  \"chainId\": 1,\n  \"symbolName\": \"ETH\",\n  \"rpcUrls\": [\n    \"https://rpc.example.com\"\n  ],\n  \"environmentType\": \"ENVIRONMENT_TYPE_MAINNET\",\n  \"decimals\": 18,\n  \"blockExplorerUrl\": \"https://etherscan.io\",\n  \"blockExplorerTransactionPath\": \"/tx\",\n  \"blockExplorerAddressPath\": \"/address\",\n  \"networkId\": 1,\n  \"hasFee\": true,\n  \"isPoa\": false,\n  \"hasLayeredFee\": false,\n  \"nodeType\": \"NODE_TYPE_CORE_GETH\",\n  \"transactionFormat\": 0,\n  \"baseAssetTenantIds\": [\n    \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n  ],\n  \"explorerApiUrl\": \"https://api.etherscan.io\",\n  \"explorerApiKey\": \"my-explorer-api-key\",\n  \"isTraceEnabled\": false\n}"

response = http.request(request)
puts response.read_body

{
  "blockchain": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "blockchainState": "BLOCKCHAIN_STATE_ACTIVATED",
    "declaredProperties": {
      "chainName": "Ethereum",
      "chainId": 1,
      "symbolName": "ETH",
      "rpcUrls": [
        "https://rpc.example.com"
      ],
      "environmentType": "ENVIRONMENT_TYPE_MAINNET",
      "decimals": 18,
      "blockExplorerUrl": "https://etherscan.io",
      "blockExplorerTransactionPath": "/tx",
      "blockExplorerAddressPath": "/address",
      "networkId": 1,
      "hasFee": true,
      "isPoa": false,
      "hasLayeredFee": false,
      "nodeType": "NODE_TYPE_CORE_GETH",
      "transactionFormat": 0,
      "baseAssetTenantIds": [
        "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      ],
      "explorerApiUrl": "https://api.etherscan.io",
      "explorerApiKey": "my-explorer-api-key",
      "isTraceEnabled": false,
      "rpcAuth": {
        "type": "RPC_AUTH_BASIC",
        "username": "rpc_user",
        "password": "my-password",
        "token": "my-bearer-token",
        "headerName": "X-Custom-Auth",
        "headerValue": "my-header-value"
      }
    },
    "createdAtUtc": 1700000000000,
    "updatedAtUtc": 1700000000000,
    "validationFailureReasons": [
      "RPC endpoint unreachable"
    ],
    "validationSessionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "validationStatus": "VALIDATION_STATUS_SUCCEEDED",
    "validationCreatedAtUtc": 1700000000000,
    "validationUpdatedAtUtc": 1700000000000,
    "validationCompletedAtUtc": 1700000000000,
    "failedStep": "FAILED_STEP_CONFIGURATION"
  },
  "message": "Blockchain updated successfully"
}

{
  "message": "<string>",
  "code": 123
}