zkSync Era

/getbalance

Get the balance or number of the given token in the requested public address.

GET https://api.expand.network/chain/getbalance

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
blockNumber	String	Block number for which the balance needs to be retrieved. By default, it will pick the latest block number when not specified.
address*	String	The public address to get the balance of.
tokenAddress	String	The address of token to get the balance of.

Sample Request

https://api.expand.network/chain/getbalance?chainId=324&blockNumber=35710825&address=0x5f5BB2b9A16d48541d38E048E94a9CD713bD6Cb7&tokenAddress=0x3355df6D4c9C3035724Fd0e3914dE96A5a83aaf4

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "177900"
    }
}

/getblock

Get details of a block.

GET https://historicallp.api.expand.network/chain/getblock

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
blockNumber*	String	The block number or block hash.

Sample Request

https://historicallp.api.expand.network/chain/getblock?blockNumber=696293&chainId=324

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "baseFeePerGas": 250000000,
    "difficulty": "0",
    "extraData": "0x",
    "gasLimit": 4294967295,
    "gasUsed": 3273403,
    "hash": "0x978dd7094735b8621254f26a875f020413ef7a498ad5dce79ab322bf5c4e5313",
    "l1BatchNumber": "0x1c05",
    "l1BatchTimestamp": "0x642a40e5",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0x0000000000000000000000000000000000000000",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x0000000000000000",
    "number": 696293,
    "parentHash": "0x0019d93c7755306ee4861d6e203fe3bf754fab46c24d74f9a700a46b236c023f",
    "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "sealFields": [],
    "size": 0,
    "timestamp": 1680490794,
    "totalDifficulty": "0",
    "transactions": [
      {
        "chainId": "324",
        "hash": "0x638118f1c0ee1ec486d54e3928839380cac1c32952b9938c6ce83ec068bb4552",
        "transactionStatus": true,
        "blockNumber": "696293",
        "timestamp": null,
        "from": "0x4a16466fCE63B2c79e562A35Dad32E9F3cAEF90d",
        "to": "0xD0eA21ba66B67bE636De1EC4bd9696EB8C61e9AA",
        "value": "0",
        "transactionFees": "107598250000000",
        "gas": "764969",
        "gasPrice": "250000000",
        "input": "0x095ea7b30000000000000000000000002da10a1e27bf85cedd8ffb1abbe97e53391c02950000000000000000000000000000000000000000000000001bc16d674ec80000",
        "nonce": 4,
        "type": null,
        "network": null,
        "v": "0x2ab",
        "r": "0x5e405172ff1cbf5b4af2595c15f67e79c7049efd3f990611950c511a10494468",
        "s": "0x78ca1efdb6e3cce11267a9d17de75aee293da3f0406396f3d08a8fc4c2345b8a",
        "yParity": null,
        "transactionIndex": null,
        "accessList": null,
        "maxFeePerGas": "260000000",
        "maxPriorityFeePerGas": "260000000",
        "logs": []
      }
    ],
    "transactionsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "uncles": []
  }
}

/getgasprice

Get the current gas price from the network.

GET https://api.expand.network/chain/getgasprice

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.

Sample Request

https://api.expand.network/chain/getgasprice?chainId=324

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "gasPrice": "100000000"
    }
}

/getstorage

Get data stored in the given slot.

GET https://api.expand.network/chain/getstorage

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
address*	String	Contract address whose storage is needed.
index	String	Slot index on the smart contract. By default, it is taken as 0.

Sample Request

https://api.expand.network/chain/getstorage?address=0x32Fd44bB869620C0EF993754c8a00Be67C464806&chainId=324&index=0

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "data": "0x0000000000000000000000000000000000000000000000000000000000000001"
    }
}

/gettransaction

Get details of a transaction.

GET https://api.expand.network/chain/gettransaction

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
transactionHash*	String	The transaction hash.

Sample Request

https://api.expand.network/chain/gettransaction?chainId=324&transactionHash=0xe43b77386a5e5bdffaa62b347044cfd28b71947b6c9869046a1df644a3b83bb0

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "324",
    "hash": "0xe43b77386a5e5bdffaa62b347044cfd28b71947b6c9869046a1df644a3b83bb0",
    "transactionStatus": true,
    "blockNumber": "26972503",
    "timestamp": null,
    "from": "0xBf1C2eD425398FD04ecf319BEbd39EC487eEFeDF",
    "to": "0x3355df6D4c9C3035724Fd0e3914dE96A5a83aaf4",
    "value": "0",
    "transactionFees": "47253200000000",
    "gas": "1056669",
    "gasPrice": "100000000",
    "input": "0x095ea7b3000000000000000000000000f8b59f3c3ab33200ec80a8a58b2aa5f5d2a8944cffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
    "nonce": 50,
    "type": 2,
    "network": null,
    "v": "0x0",
    "r": "0x45f3755db709c047dd9305f891fb44903f1dd6cf7a18747202d97a1b6a07e6bd",
    "s": "0x14f97115c291f73c75ea7d4f5b8d2019fcb33e934c65ab193929075591abc83d",
    "yParity": null,
    "transactionIndex": 25,
    "accessList": null,
    "maxFeePerGas": "135000000",
    "maxPriorityFeePerGas": "0",
    "logs": [
      {
        "address": "0x000000000000000000000000000000000000800A",
        "blockHash": "0x01f0e4321958ad440ccc627214933209614abac4f5534a8f15a13a2a92f97037",
        "blockNumber": 26972503,
        "data": "0x000000000000000000000000000000000000000000000000000081bd5d5a48c0",
        "l1BatchNumber": "0x6b911",
        "logIndex": 136,
        "logType": null,
        "removed": false,
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x000000000000000000000000bf1c2ed425398fd04ecf319bebd39ec487eefedf",
          "0x0000000000000000000000000000000000000000000000000000000000008001"
        ],
        "transactionHash": "0xe43b77386a5e5bdffaa62b347044cfd28b71947b6c9869046a1df644a3b83bb0",
        "transactionIndex": 25,
        "transactionLogIndex": "0x0",
        "id": "log_d7912a52"
      },
      {
        "address": "0x000000000000000000000000000000000000800A",
        "blockHash": "0x01f0e4321958ad440ccc627214933209614abac4f5534a8f15a13a2a92f97037",
        "blockNumber": 26972503,
        "data": "0x000000000000000000000000000000000000000000000000000021a2df504bc0",
        "l1BatchNumber": "0x6b911",
        "logIndex": 137,
        "logType": null,
        "removed": false,
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x0000000000000000000000000000000000000000000000000000000000008001",
          "0x000000000000000000000000bf1c2ed425398fd04ecf319bebd39ec487eefedf"
        ],
        "transactionHash": "0xe43b77386a5e5bdffaa62b347044cfd28b71947b6c9869046a1df644a3b83bb0",
        "transactionIndex": 25,
        "transactionLogIndex": "0x1",
        "id": "log_66ae4e73"
      },
      {
        "address": "0x3355df6D4c9C3035724Fd0e3914dE96A5a83aaf4",
        "blockHash": "0x01f0e4321958ad440ccc627214933209614abac4f5534a8f15a13a2a92f97037",
        "blockNumber": 26972503,
        "data": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "l1BatchNumber": "0x6b911",
        "logIndex": 138,
        "logType": null,
        "removed": false,
        "topics": [
          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
          "0x000000000000000000000000bf1c2ed425398fd04ecf319bebd39ec487eefedf",
          "0x000000000000000000000000f8b59f3c3ab33200ec80a8a58b2aa5f5d2a8944c"
        ],
        "transactionHash": "0xe43b77386a5e5bdffaa62b347044cfd28b71947b6c9869046a1df644a3b83bb0",
        "transactionIndex": 25,
        "transactionLogIndex": "0x2",
        "id": "log_e96517f9"
      },
      {
        "address": "0x000000000000000000000000000000000000800A",
        "blockHash": "0x01f0e4321958ad440ccc627214933209614abac4f5534a8f15a13a2a92f97037",
        "blockNumber": 26972503,
        "data": "0x000000000000000000000000000000000000000000000000000035207fd6a900",
        "l1BatchNumber": "0x6b911",
        "logIndex": 139,
        "logType": null,
        "removed": false,
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x0000000000000000000000000000000000000000000000000000000000008001",
          "0x000000000000000000000000bf1c2ed425398fd04ecf319bebd39ec487eefedf"
        ],
        "transactionHash": "0xe43b77386a5e5bdffaa62b347044cfd28b71947b6c9869046a1df644a3b83bb0",
        "transactionIndex": 25,
        "transactionLogIndex": "0x3",
        "id": "log_350928fb"
      }
    ]
  }
}

/sendtransaction

Send transaction on the chain.

POST https://api.expand.network/chain/sendtransaction

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
rawTransaction*	String	The encoded transaction, obtained from the signed transaction.

Sample Request

{
    "rawTransaction": "0xf86d0d8405f5e100830927c0946fb447ae94f5180254d436a693907a1f5769690087038d7ea4c680008082027ba0d73a953d53eb64f90c7c91273df70074021ec9d6aa2280ba53527086a5d45f65a0273ee55497b2374af9b244af11a2e5a02f94137385fac51ef51f21908a18ca57",
    "chainId": "324"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "324",
        "transactionHash": "0x7d987e52e0b106a2171919775970089b052857046fbf32137c8c445f10d6d69f" 
    }
}

/decodetransaction

Get the decoded transaction for the provided raw transaction.

POST https://api.expand.network/chain/decodetransaction

Request Body

Name	Type	Description
chainId	String	Refer to the Chain ID page for details. By default, Ethereum.
chainSymbol	String	Refer to the Chain ID page for details.
rawTransaction*	String	The raw transaction to be given for decoding.

Sample Request

{
    "rawTransaction": "0xf86d808405f5e100830927c0946fb447ae94f5180254d436a693907a1f5769690087038d7ea4c68000808202aca0535316a857d5c6f59ee228509cf9eb638905250548c7a7effcc6ebff22bca4dea012a9859bf2f663521c9832f1d118de7d548e119b5d9b07ff6d6d349025b3f8b2"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "parsedTx": {
            "nonce": 0,
            "gasPrice": {
                "type": "BigNumber",
                "hex": "0x05f5e100"
            },
            "gasLimit": {
                "type": "BigNumber",
                "hex": "0x0927c0"
            },
            "to": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
            "value": {
                "type": "BigNumber",
                "hex": "0x038d7ea4c68000"
            },
            "data": "0x",
            "chainId": 324,
            "v": 684,
            "r": "0x535316a857d5c6f59ee228509cf9eb638905250548c7a7effcc6ebff22bca4de",
            "s": "0x12a9859bf2f663521c9832f1d118de7d548e119b5d9b07ff6d6d349025b3f8b2",
            "from": "0x56D2208EfD27Fe9C67e3879DeBCe35833B9D4cC7",
            "hash": "0x90521267c0d1e6f72398e1bc1d45552415145126656a385c07494c56832ea3c9",
            "type": null
        },
        "assetChanges": {
            "from": "0x56D2208EfD27Fe9C67e3879DeBCe35833B9D4cC7",
            "to": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
            "value": {
                "type": "BigNumber",
                "hex": "0x038d7ea4c68000"
            }
        }
    }
}