Contract

Smart contract operations and state queries

Validate WASM contract

post

https://nodes.amadeus.bothttps://testnet-rpc.ama.one

/api/contract/validate

Validate a WASM contract bytecode before deployment

Body

application/octet-stream

string · binaryOptional

WASM bytecode

Responses

200

Validation result

application/json

errorstringOptional

validbooleanOptional

post

/api/contract/validate

HTTPcURLJavaScriptPython

POST /api/contract/validate HTTP/1.1
Host: nodes.amadeus.bot
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

200

Validation result

{
  "error": "text",
  "valid": true
}

Get contract state by key

post

https://nodes.amadeus.bothttps://testnet-rpc.ama.one

/api/contract/get

Retrieve a value from contract state storage

Body

application/octet-stream

string · binaryOptional

Storage key (raw bytes)

Responses

200

Contract state value

application/json

objectOptional

post

/api/contract/get

HTTPcURLJavaScriptPython

POST /api/contract/get HTTP/1.1
Host: nodes.amadeus.bot
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

200

Contract state value

{}

Get contract state by prefix

post

https://nodes.amadeus.bothttps://testnet-rpc.ama.one

/api/contract/get_prefix

Retrieve all key-value pairs from contract state with a given prefix

Body

application/octet-stream

string · binaryOptional

Storage key prefix (raw bytes)

Responses

200

Contract state entries (vecpak encoded)

application/octet-stream

string · binaryOptional

post

/api/contract/get_prefix

HTTPcURLJavaScriptPython

POST /api/contract/get_prefix HTTP/1.1
Host: nodes.amadeus.bot
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

200

Contract state entries (vecpak encoded)

binary

Execute contract view function (GET)

get

https://nodes.amadeus.bothttps://testnet-rpc.ama.one

/api/contract/view

Execute a read-only contract function with no arguments

Path parameters

contractstringRequired

Contract address (Base58 encoded)

functionstringRequired

Function name

Query parameters

pkstringOptional

Caller public key (Base58 encoded)

Responses

200

Function execution result

application/json

successbooleanOptional

resultstringOptional

logsstring[]Optional

get

/api/contract/view

HTTPcURLJavaScriptPython

GET /api/contract/view HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Function execution result

{
  "success": true,
  "result": "text",
  "logs": [
    "text"
  ]
}

Execute contract view function (vecpak)

post

https://nodes.amadeus.bothttps://testnet-rpc.ama.one

/api/contract/view

Execute a read-only contract function using vecpak encoding

Body

application/octet-stream

string · binaryOptional

Vecpak encoded map with fields:

• contract: Contract address (48 bytes)
• function: Function name (string)
• args: Function arguments (array)
• pk: Optional caller public key (48 bytes)

Responses

200

Function execution result

application/json

successbooleanOptional

resultstringOptional

Execution result (ASCII dump)

logsstring[]Optional

Execution logs

post

/api/contract/view

HTTPcURLJavaScriptPython

POST /api/contract/view HTTP/1.1
Host: nodes.amadeus.bot
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

200

Function execution result

{
  "success": true,
  "result": "text",
  "logs": [
    "text"
  ]
}

Get richlist

get

https://nodes.amadeus.bothttps://testnet-rpc.ama.one

/api/contract/richlist

Retrieve the list of top AMA token holders

Responses

200

Richlist

application/json

errorstringOptionalExample: ok

get

/api/contract/richlist

HTTPcURLJavaScriptPython

GET /api/contract/richlist HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Richlist

{
  "error": "ok",
  "richlist": [
    {
      "address": "text",
      "balance": "text"
    }
  ]
}