ONonflow
Contracts

Get contract by identifier

Changed on

Returns the latest deployment for the contract with the given identifier.

get/experimental/v1/contracts/{identifier}

Request

  • Base URL
    https://rest-testnet.onflow.org
  • URL
    https://rest-testnet.onflow.org/experimental/v1/contracts/{identifier}
  • Auth
    none required

Path parameters

identifierstring required

Address-qualified Cadence contract identifier (e.g. A.1654653399040a61.EVM).

The case sensitive address-qualified contract identifier (e.g. A.1654653399040a61.EVM).

Query parameters

expandstring[]

A comma-separated list indicating which properties of the content to expand.

selectstring[]

A comma-separated list indicating which properties of the content to return.

Response

The contract deployment.

contract_idstring required

Address-qualified Cadence contract identifier (e.g. A.1654653399040a61.EVM).

addressstring hexadecimal required

The 8-byte address of an account.

block_heightstring uint64

Block height at which this deployment was applied.

transaction_idstring hexadecimal

A 32-byte unique identifier for an entity.

tx_indexstring uint32

Position of the deploying transaction within its block.

event_indexstring uint32

Position of the contract event within its transaction.

codestring byte

Base64-encoded Cadence source code of the contract deployed.

code_hashstring hexadecimal required

Hex-encoded SHA3-256 hash of the contract code.

is_placeholderboolean

True if the deployment was created during bootstrapping based on the current chain state, not based on a protocol event. When true, block_height, transaction_id, tx_index, and event_index are absent.

Changes

  • 70791e5544f0Revision changes
    • breaking

      the response property became optional for the status

    • info

      added the optional property / to the response with the status

  • 5dbfe72ac388Revision changes
    • info

      added the optional property to the response with the status