Contracts

Compile a contract script

post

Compiles a contract script written in ALPH TxScript language. Returns metadata about the compiled bytecode, fields, functions, and any warnings.

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

codestringOptional

The contract script source code in TxScript language

Example: TxScript Main { let token = Token(#36cdbfabca2d71622b6) token.withdraw(@1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y, 1024) }

Responses

200

Compilation result with bytecode and metadata

application/json

versionstringOptional

Version of the compiler used

Example: v0.0.1

namestringOptional

Name of the contract

Example: Main

bytecodeTemplatestringOptional

Bytecode template of the compiled contract

Example: 35d1b2a520a0da34c5eb8d712aa9cc

bytecodeDebugPatchstringOptional

Debug patch information for the bytecode

Example: =1-1+ef

warningsstring[]Optional

List of compilation warnings

Example: ["Found unused fields in Foo: a"]

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/compile-script

HTTPcURLJavaScriptPython

POST /contracts/compile-script HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 192

{
  "code": "TxScript Main { let token = Token(#36cdbfabca2d71622b6) token.withdraw(@1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y, 1024) }",
  "compilerOptions": {
    "ignoreUnusedConstantsWarnings": true
  }
}

{
  "version": "v0.0.1",
  "name": "Main",
  "bytecodeTemplate": "35d1b2a520a0da34c5eb8d712aa9cc",
  "bytecodeDebugPatch": "=1-1+ef",
  "fields": {
    "names": [
      "aa",
      "bb",
      "cc",
      "dd",
      "ee"
    ],
    "types": [
      "Bool",
      "U256",
      "I256",
      "ByteVec",
      "Address"
    ],
    "isMutable": [
      false,
      true,
      false,
      true,
      false
    ]
  },
  "functions": [
    {
      "name": "bar",
      "usePreapprovedAssets": false,
      "useAssetsInContract": false,
      "isPublic": true,
      "paramNames": [
        "a",
        "b",
        "c",
        "d",
        "e"
      ],
      "paramTypes": [
        "Bool",
        "U256",
        "I256",
        "ByteVec",
        "Address"
      ],
      "paramIsMutable": [
        false,
        true,
        false,
        true,
        false
      ],
      "returnTypes": [
        "U256",
        "I256",
        "ByteVec",
        "Address"
      ]
    }
  ],
  "warnings": [
    "Found unused fields in Foo: a"
  ]
}

Execute script

post

Build an unsigned script

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

fromPublicKeystring · hex-stringRequired

fromPublicKeyTypestring · hex-stringOptional

bytecodestring · hex-stringRequired

attoAlphAmountstring · uint256Optional

gasAmountinteger · gasOptional

gasPricestring · uint256Optional

targetBlockHashstring · block-hashOptional

gasEstimationMultipliernumber · doubleOptional

Responses

200

Valid response

application/json

fromGroupinteger · int32Required

toGroupinteger · int32Required

unsignedTxstringRequired

gasAmountinteger · gasRequired

gasPricestring · uint256Required

txIdstring · 32-byte-hashRequired

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/unsigned-tx/execute-script

HTTPcURLJavaScriptPython

POST /contracts/unsigned-tx/execute-script HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "fromPublicKey": "d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28",
  "bytecode": "35d1b2a520a0da34c5eb8d712aa9cc"
}

DefaultMore settings

{
  "fromGroup": 2,
  "toGroup": 2,
  "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc",
  "gasAmount": 20000,
  "gasPrice": "100000000000",
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69"
}

Compile contract

post

Compile a smart contract

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

codestringRequired

Responses

200

Valid response

application/json

versionstringRequired

namestringRequired

bytecodestringRequired

bytecodeDebugPatchstringRequired

codeHashstring · 32-byte-hashRequired

codeHashDebugstring · 32-byte-hashRequired

warningsstring[]Required

stdInterfaceIdstringOptional

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/compile-contract

HTTPcURLJavaScriptPython

POST /contracts/compile-contract HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 156

{
  "code": "Contract Foo(bar: ByteVec) {\n pub fn baz(amount: U256) -> () {\nissueToken!(amount)\n}}",
  "compilerOptions": {
    "ignoreUnusedConstantsWarnings": true
  }
}

{
  "version": "v0.0.1",
  "name": "Foo",
  "bytecode": "35d1b2a520a0da34c5eb8d712aa9cc",
  "bytecodeDebugPatch": "=1-1+ef",
  "codeHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "codeHashDebug": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "fields": {
    "names": [
      "aa",
      "bb",
      "cc",
      "dd",
      "ee"
    ],
    "types": [
      "Bool",
      "U256",
      "I256",
      "ByteVec",
      "Address"
    ],
    "isMutable": [
      false,
      true,
      false,
      true,
      false
    ]
  },
  "functions": [
    {
      "name": "bar",
      "usePreapprovedAssets": false,
      "useAssetsInContract": false,
      "isPublic": true,
      "paramNames": [
        "a",
        "b",
        "c",
        "d",
        "e"
      ],
      "paramTypes": [
        "Bool",
        "U256",
        "I256",
        "ByteVec",
        "Address"
      ],
      "paramIsMutable": [
        false,
        true,
        false,
        true,
        false
      ],
      "returnTypes": [
        "U256",
        "I256",
        "ByteVec",
        "Address"
      ]
    }
  ],
  "constants": [
    {
      "name": "A",
      "value": {
        "type": "Bool",
        "value": true
      }
    }
  ],
  "enums": [
    {
      "name": "Color",
      "fields": [
        {
          "name": "Red",
          "value": {
            "type": "U256",
            "value": "0"
          }
        },
        {
          "name": "Blue",
          "value": {
            "type": "U256",
            "value": "1"
          }
        }
      ]
    }
  ],
  "events": [
    {
      "name": "Bar",
      "fieldNames": [
        "a",
        "b",
        "d",
        "e"
      ],
      "fieldTypes": [
        "Bool",
        "U256",
        "ByteVec",
        "Address"
      ]
    }
  ],
  "warnings": [
    "Found unused fields in Foo: a"
  ],
  "maps": {
    "names": [
      "foo"
    ],
    "types": [
      "Map[U256,U256]"
    ]
  },
  "stdInterfaceId": "0001"
}

Compile a project

post

Compile project

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

codestringRequired

Responses

200

Valid response

application/json

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/compile-project

HTTPcURLJavaScriptPython

POST /contracts/compile-project HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 163

{
  "code": "Contract Foo() {\n pub fn foo() -> () {}\n }\n TxScript Main(id: ByteVec) {\n Foo(id).foo() \n}",
  "compilerOptions": {
    "ignoreUnusedConstantsWarnings": true
  }
}

{
  "contracts": [
    {
      "version": "v0.0.1",
      "name": "Foo",
      "bytecode": "35d1b2a520a0da34c5eb8d712aa9cc",
      "bytecodeDebugPatch": "=1-1+ef",
      "codeHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
      "codeHashDebug": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
      "fields": {
        "names": [
          "aa",
          "bb",
          "cc",
          "dd",
          "ee"
        ],
        "types": [
          "Bool",
          "U256",
          "I256",
          "ByteVec",
          "Address"
        ],
        "isMutable": [
          false,
          true,
          false,
          true,
          false
        ]
      },
      "functions": [
        {
          "name": "bar",
          "usePreapprovedAssets": false,
          "useAssetsInContract": false,
          "isPublic": true,
          "paramNames": [
            "a",
            "b",
            "c",
            "d",
            "e"
          ],
          "paramTypes": [
            "Bool",
            "U256",
            "I256",
            "ByteVec",
            "Address"
          ],
          "paramIsMutable": [
            false,
            true,
            false,
            true,
            false
          ],
          "returnTypes": [
            "U256",
            "I256",
            "ByteVec",
            "Address"
          ]
        }
      ],
      "constants": [
        {
          "name": "A",
          "value": {
            "type": "Bool",
            "value": true
          }
        }
      ],
      "enums": [
        {
          "name": "Color",
          "fields": [
            {
              "name": "Red",
              "value": {
                "type": "U256",
                "value": "0"
              }
            },
            {
              "name": "Blue",
              "value": {
                "type": "U256",
                "value": "1"
              }
            }
          ]
        }
      ],
      "events": [
        {
          "name": "Bar",
          "fieldNames": [
            "a",
            "b",
            "d",
            "e"
          ],
          "fieldTypes": [
            "Bool",
            "U256",
            "ByteVec",
            "Address"
          ]
        }
      ],
      "warnings": [
        "Found unused fields in Foo: a"
      ],
      "maps": {
        "names": [
          "foo"
        ],
        "types": [
          "Map[U256,U256]"
        ]
      },
      "stdInterfaceId": "0001"
    }
  ],
  "scripts": [
    {
      "version": "v0.0.1",
      "name": "Main",
      "bytecodeTemplate": "35d1b2a520a0da34c5eb8d712aa9cc",
      "bytecodeDebugPatch": "=1-1+ef",
      "fields": {
        "names": [
          "aa",
          "bb",
          "cc",
          "dd",
          "ee"
        ],
        "types": [
          "Bool",
          "U256",
          "I256",
          "ByteVec",
          "Address"
        ],
        "isMutable": [
          false,
          true,
          false,
          true,
          false
        ]
      },
      "functions": [
        {
          "name": "bar",
          "usePreapprovedAssets": false,
          "useAssetsInContract": false,
          "isPublic": true,
          "paramNames": [
            "a",
            "b",
            "c",
            "d",
            "e"
          ],
          "paramTypes": [
            "Bool",
            "U256",
            "I256",
            "ByteVec",
            "Address"
          ],
          "paramIsMutable": [
            false,
            true,
            false,
            true,
            false
          ],
          "returnTypes": [
            "U256",
            "I256",
            "ByteVec",
            "Address"
          ]
        }
      ],
      "warnings": [
        "Found unused fields in Foo: a"
      ]
    }
  ],
  "structs": [
    {
      "name": "Foo",
      "fieldNames": [
        "amount",
        "id"
      ],
      "fieldTypes": [
        "U256",
        "ByteVec"
      ],
      "isMutable": [
        false,
        true
      ]
    }
  ]
}

Build an unsigned contract

post

Deploy-contract

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

fromPublicKeystring · hex-stringRequired

fromPublicKeyTypestring · hex-stringOptional

bytecodestring · hex-stringRequired

initialAttoAlphAmountstring · uint256Optional

issueTokenAmountstring · uint256Optional

issueTokenTostring · addressOptional

gasAmountinteger · gasOptional

gasPricestring · uint256Optional

targetBlockHashstring · block-hashOptional

Responses

200

Valid response

application/json

fromGroupinteger · int32Required

toGroupinteger · int32Required

unsignedTxstringRequired

gasAmountinteger · gasRequired

gasPricestring · uint256Required

txIdstring · 32-byte-hashRequired

contractAddressstring · addressRequired

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/unsigned-tx/deploy-contract

HTTPcURLJavaScriptPython

POST /contracts/unsigned-tx/deploy-contract HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "fromPublicKey": "d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28",
  "bytecode": "35d1b2a520a0da34c5eb8d712aa9cc"
}

DefaultMore settings

{
  "fromGroup": 2,
  "toGroup": 2,
  "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc",
  "gasAmount": 20000,
  "gasPrice": "100000000000",
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
  "contractAddress": "vSxdLL2kE3o6vJBdKkdgmS3W39G3ZEmFHpo2y1jnbzBq"
}

Get contract state

get

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

addressstring · addressRequired

Responses

200

Valid response

application/json

addressstring · addressRequired

bytecodestring · contractRequired

codeHashstring · 32-byte-hashRequired

initialStateHashstring · 32-byte-hashOptional

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

get/contracts/{address}/state

HTTPcURLJavaScriptPython

GET /contracts/{address}/state HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "address": "vYZdgzNHHp7Qh9U5Rrv5H65eSJCGQTXEC4yuQCZ7mosA",
  "bytecode": "00010700000000000118",
  "codeHash": "c49d951065f85d0c673d33930e8476240c010a52313f99889ae06d9f0d92d2f9",
  "initialStateHash": "e195a4e597e62a6802a456224008b896566b7c961023954fab808a0f83d8ad63",
  "immFields": [
    {
      "type": "U256",
      "value": "1000000000000000000"
    }
  ],
  "mutFields": [
    {
      "type": "U256",
      "value": "2000000000000000000"
    }
  ],
  "asset": {
    "attoAlphAmount": "2000000000000000000",
    "tokens": [
      {
        "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
        "amount": "2000000000"
      }
    ]
  }
}

Test contract

post

Test contract

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

groupinteger · int32Optional

blockHashstring · block-hashOptional

blockTimeStampinteger · int64Optional

txIdstring · 32-byte-hashOptional

addressstring · addressOptional

callerAddressstring · addressOptional

bytecodestring · contractRequired

methodIndexinteger · int32Optional

Responses

200

Valid response

application/json

addressstring · addressRequired

codeHashstring · 32-byte-hashRequired

gasUsedinteger · int32Required

txInputsstring · address[]Required

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/test-contract

HTTPcURLJavaScriptPython

POST /contracts/test-contract HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1255

{
  "group": 0,
  "address": "tgx7VNFoP9DJiFMFgXXtafQZkUvyEdDHT9ryamHJYrjq",
  "bytecode": "00010700000000000118",
  "initialImmFields": [
    {
      "type": "U256",
      "value": "1000000000000000000"
    }
  ],
  "initialMutFields": [
    {
      "type": "U256",
      "value": "2000000000000000000"
    }
  ],
  "initialAsset": {
    "attoAlphAmount": "1000000000000000000",
    "tokens": [
      {
        "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
        "amount": "1000000000"
      }
    ]
  },
  "methodIndex": 0,
  "args": [
    {
      "type": "U256",
      "value": "1000000000000000000"
    }
  ],
  "existingContracts": [
    {
      "address": "vYZdgzNHHp7Qh9U5Rrv5H65eSJCGQTXEC4yuQCZ7mosA",
      "bytecode": "00010700000000000118",
      "codeHash": "c49d951065f85d0c673d33930e8476240c010a52313f99889ae06d9f0d92d2f9",
      "initialStateHash": "e195a4e597e62a6802a456224008b896566b7c961023954fab808a0f83d8ad63",
      "immFields": [
        {
          "type": "U256",
          "value": "1000000000000000000"
        }
      ],
      "mutFields": [
        {
          "type": "U256",
          "value": "2000000000000000000"
        }
      ],
      "asset": {
        "attoAlphAmount": "2000000000000000000",
        "tokens": [
          {
            "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
            "amount": "2000000000"
          }
        ]
      }
    }
  ],
  "inputAssets": [
    {
      "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
      "asset": {
        "attoAlphAmount": "3000000000000000000",
        "tokens": [
          {
            "id": "20aa1fcc865087d7788302d087e4bc76691218ce5d5013dd1cedaabfac19cca4",
            "amount": "3000000000"
          }
        ]
      }
    }
  ]
}

{
  "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
  "codeHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "returns": [
    {
      "type": "U256",
      "value": "1000000000000000000"
    }
  ],
  "gasUsed": 20000,
  "contracts": [
    {
      "address": "vYZdgzNHHp7Qh9U5Rrv5H65eSJCGQTXEC4yuQCZ7mosA",
      "bytecode": "00010700000000000118",
      "codeHash": "c49d951065f85d0c673d33930e8476240c010a52313f99889ae06d9f0d92d2f9",
      "initialStateHash": "e195a4e597e62a6802a456224008b896566b7c961023954fab808a0f83d8ad63",
      "immFields": [
        {
          "type": "U256",
          "value": "1000000000000000000"
        }
      ],
      "mutFields": [
        {
          "type": "U256",
          "value": "2000000000000000000"
        }
      ],
      "asset": {
        "attoAlphAmount": "2000000000000000000",
        "tokens": [
          {
            "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
            "amount": "2000000000"
          }
        ]
      }
    }
  ],
  "txInputs": [
    "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S"
  ],
  "txOutputs": [
    {
      "type": "ContractOutput",
      "hint": 1234,
      "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
      "attoAlphAmount": "1000000000000000000",
      "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
      "tokens": [
        {
          "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
          "amount": "42000000000000000000"
        },
        {
          "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
          "amount": "1000000000000000000000"
        }
      ]
    }
  ],
  "events": [
    {
      "blockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
      "contractAddress": "vSxdLL2kE3o6vJBdKkdgmS3W39G3ZEmFHpo2y1jnbzBq",
      "eventIndex": 1,
      "fields": [
        {
          "type": "Address",
          "value": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
        },
        {
          "type": "U256",
          "value": "10"
        }
      ]
    }
  ],
  "debugMessages": [
    {
      "contractAddress": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
      "message": "Debugging!"
    }
  ]
}

Call contract

post

Call contract

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

groupinteger · int32Required

worldStateBlockHashstring · block-hashOptional

txIdstring · 32-byte-hashOptional

addressstring · addressRequired

callerAddressstring · addressOptional

methodIndexinteger · int32Required

interestedContractsstring · address[]Optional

Responses

200

Valid response

application/json

or

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/call-contract

HTTPcURLJavaScriptPython

POST /contracts/call-contract HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 585

{
  "group": 0,
  "worldStateBlockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
  "address": "tgx7VNFoP9DJiFMFgXXtafQZkUvyEdDHT9ryamHJYrjq",
  "methodIndex": 0,
  "args": [
    {
      "type": "U256",
      "value": "0"
    }
  ],
  "interestedContracts": [
    "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S"
  ],
  "inputAssets": [
    {
      "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
      "asset": {
        "attoAlphAmount": "3000000000000000000",
        "tokens": [
          {
            "id": "20aa1fcc865087d7788302d087e4bc76691218ce5d5013dd1cedaabfac19cca4",
            "amount": "3000000000"
          }
        ]
      }
    }
  ]
}

{
  "type": "CallContractSucceeded",
  "returns": [
    {
      "type": "U256",
      "value": "0"
    }
  ],
  "gasUsed": 20000,
  "contracts": [
    {
      "address": "vYZdgzNHHp7Qh9U5Rrv5H65eSJCGQTXEC4yuQCZ7mosA",
      "bytecode": "00010700000000000118",
      "codeHash": "c49d951065f85d0c673d33930e8476240c010a52313f99889ae06d9f0d92d2f9",
      "initialStateHash": "e195a4e597e62a6802a456224008b896566b7c961023954fab808a0f83d8ad63",
      "immFields": [
        {
          "type": "U256",
          "value": "1000000000000000000"
        }
      ],
      "mutFields": [
        {
          "type": "U256",
          "value": "2000000000000000000"
        }
      ],
      "asset": {
        "attoAlphAmount": "2000000000000000000",
        "tokens": [
          {
            "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
            "amount": "2000000000"
          }
        ]
      }
    }
  ],
  "txInputs": [
    "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S"
  ],
  "txOutputs": [
    {
      "type": "ContractOutput",
      "hint": 1,
      "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
      "attoAlphAmount": "1000000000000000000",
      "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
      "tokens": [
        {
          "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
          "amount": "42000000000000000000"
        },
        {
          "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
          "amount": "1000000000000000000000"
        }
      ]
    }
  ],
  "events": [
    {
      "blockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
      "contractAddress": "vSxdLL2kE3o6vJBdKkdgmS3W39G3ZEmFHpo2y1jnbzBq",
      "eventIndex": 1,
      "fields": [
        {
          "type": "Address",
          "value": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
        },
        {
          "type": "U256",
          "value": "10"
        }
      ]
    }
  ],
  "debugMessages": [
    {
      "contractAddress": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
      "message": "Debugging!"
    }
  ]
}

Multiple call contract

post

Multicall contract

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

Responses

200

Valid response

application/json

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/multicall-contract

HTTPcURLJavaScriptPython

POST /contracts/multicall-contract HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 597

{
  "calls": [
    {
      "group": 0,
      "worldStateBlockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
      "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
      "address": "tgx7VNFoP9DJiFMFgXXtafQZkUvyEdDHT9ryamHJYrjq",
      "methodIndex": 0,
      "args": [
        {
          "type": "U256",
          "value": "0"
        }
      ],
      "interestedContracts": [
        "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S"
      ],
      "inputAssets": [
        {
          "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
          "asset": {
            "attoAlphAmount": "3000000000000000000",
            "tokens": [
              {
                "id": "20aa1fcc865087d7788302d087e4bc76691218ce5d5013dd1cedaabfac19cca4",
                "amount": "3000000000"
              }
            ]
          }
        }
      ]
    }
  ]
}

{
  "results": [
    {
      "type": "CallContractSucceeded",
      "returns": [
        {
          "type": "U256",
          "value": "0"
        }
      ],
      "gasUsed": 20000,
      "contracts": [
        {
          "address": "vYZdgzNHHp7Qh9U5Rrv5H65eSJCGQTXEC4yuQCZ7mosA",
          "bytecode": "00010700000000000118",
          "codeHash": "c49d951065f85d0c673d33930e8476240c010a52313f99889ae06d9f0d92d2f9",
          "initialStateHash": "e195a4e597e62a6802a456224008b896566b7c961023954fab808a0f83d8ad63",
          "immFields": [
            {
              "type": "U256",
              "value": "1000000000000000000"
            }
          ],
          "mutFields": [
            {
              "type": "U256",
              "value": "2000000000000000000"
            }
          ],
          "asset": {
            "attoAlphAmount": "2000000000000000000",
            "tokens": [
              {
                "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                "amount": "2000000000"
              }
            ]
          }
        }
      ],
      "txInputs": [
        "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S"
      ],
      "txOutputs": [
        {
          "type": "ContractOutput",
          "hint": 1,
          "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "attoAlphAmount": "1000000000000000000",
          "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
          "tokens": [
            {
              "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
              "amount": "42000000000000000000"
            },
            {
              "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
              "amount": "1000000000000000000000"
            }
          ]
        }
      ],
      "events": [
        {
          "blockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
          "contractAddress": "vSxdLL2kE3o6vJBdKkdgmS3W39G3ZEmFHpo2y1jnbzBq",
          "eventIndex": 1,
          "fields": [
            {
              "type": "Address",
              "value": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
            },
            {
              "type": "U256",
              "value": "10"
            }
          ]
        }
      ],
      "debugMessages": [
        {
          "contractAddress": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
          "message": "Debugging!"
        }
      ]
    }
  ]
}

Call TxScript

post

Call TxScript

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

groupinteger · int32Required

bytecodestring · hex-stringRequired

callerAddressstring · addressOptional

worldStateBlockHashstring · block-hashOptional

txIdstring · 32-byte-hashOptional

interestedContractsstring · address[]Optional

Responses

200

Valid response

application/json

gasUsedinteger · int32Required

txInputsstring · address[]Required

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/contracts/call-tx-script

HTTPcURLJavaScriptPython

POST /contracts/call-tx-script HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "group": 0,
  "bytecode": "0011"
}

{
  "returns": [
    {
      "type": "U256",
      "value": "1"
    },
    {
      "type": "Bool",
      "value": false
    }
  ],
  "gasUsed": 100000,
  "contracts": [
    {
      "address": "vYZdgzNHHp7Qh9U5Rrv5H65eSJCGQTXEC4yuQCZ7mosA",
      "bytecode": "00010700000000000118",
      "codeHash": "c49d951065f85d0c673d33930e8476240c010a52313f99889ae06d9f0d92d2f9",
      "initialStateHash": "e195a4e597e62a6802a456224008b896566b7c961023954fab808a0f83d8ad63",
      "immFields": [
        {
          "type": "U256",
          "value": "1000000000000000000"
        }
      ],
      "mutFields": [
        {
          "type": "U256",
          "value": "2000000000000000000"
        }
      ],
      "asset": {
        "attoAlphAmount": "2000000000000000000",
        "tokens": [
          {
            "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
            "amount": "2000000000"
          }
        ]
      }
    }
  ],
  "txInputs": [
    "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S"
  ],
  "txOutputs": [
    {
      "type": "ContractOutput",
      "hint": 1,
      "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
      "attoAlphAmount": "1000000000000000000",
      "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
      "tokens": [
        {
          "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
          "amount": "42000000000000000000"
        },
        {
          "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
          "amount": "1000000000000000000000"
        }
      ]
    }
  ],
  "events": [],
  "debugMessages": []
}