listContracts | Circle

SDK Explorer

Developer Controlled Wallets

Getting Started

Methods Overview

Developer Account

Initialization

Transactions

Monitored Tokens

Webhook Subscriptions

Wallets

Wallet Sets

Token Lookup

Faucet

Signing

listContractsNode.js,latest

Go to NPM

Fetch a list of contracts that you've imported and/or deployed.

Parameters

input

object

Represents the input for fetching all contracts.

Show 10 properties

blockchain

string

The blockchain network that the resource is to be created on or is currently on. Required along with sourceAddress if you don't provide walletId. The blockchain and walletId fields are mutually exclusive.

Allowed valuesARBARB-SEPOLIABASEBASE-SEPOLIAETHETH-SEPOLIAMATICMATIC-AMOYOPOP-SEPOLIAUNIUNI-SEPOLIA

contractInputType

string

The input type for the contract.

Allowed valuesAUTO_IMPORTBYTECODEIMPORTTEMPLATE

deployerAddress

string

Filter contracts by deployer address.

name

string

Filter contracts by name.

status

string

The status of the contract.

Allowed valuesCOMPLETEFAILEDPENDING

from

string

Start time of the query, inclusive.

pageAfter

string

Used to return items after the specified item exclusively. SHOULD NOT be used in conjunction with pageBefore.

pageBefore

string

Used to return items before the specified item exclusively. SHOULD NOT be used in conjunction with pageAfter.

pageSize

number

The number of items to return.

string

End time of the query, inclusive. Defaults to the current time.

Responses

Data - ContractsResponse

Response Body

object

data

object

Required

Show 1 properties

contracts

array of objects

Required

Contracts are all the contracts that match criteria.

Show 25 properties

string

Required

System-generated unique identifier of the resource.

deployerWalletID

string

The id of the Circle Wallet that deployed this contract.

deploymentTransactionId

string

The id of the deployment transaction for this contract.

txHash

string

Blockchain generated identifier of the transaction.

abiJson

string

The contract's ABI in a JSON stringified format.

archived

boolean

Required

The archive state of the contract. If true, the contract will not be visible in your dashboard.

blockchain

string

Required

Allowed valuesETHETH-SEPOLIAMATICMATIC-AMOYARBARB-SEPOLIAUNIUNI-SEPOLIABASEBASE-SEPOLIAOPOP-SEPOLIA

bytecode

string

Bytecode of the contract being deployed.

contractAddress

string

The on-chain address of this contract.

contractInputType

string

Required

The input type for the contract.

Allowed valuesIMPORTBYTECODETEMPLATEAUTO_IMPORT

deployerAddress

string

The address that created this contract, if deployed.

deployerUserID

string

deploymentErrorReason

string

deploymentErrorDetails

string

name

string

Required

The name for a contract. Must be alphanumeric [a-zA-Z0-9].

description

string

The description for a contract.

status

string

Required

The status of the contract.

Allowed valuesPENDINGFAILEDCOMPLETE

verificationStatus

string

Required

The verification status of the contract.

Allowed valuesUNVERIFIEDVERIFIED

metadataLink

string

The ipfs metadata link of the contract.

updateDate

string

Required

Date and time the resource was last updated, in ISO-8601 UTC format.

createDate

string

Required

Date and time the resource was created, in ISO-8601 UTC format.

sourceCode

array of objects

Required

Show 2 properties

fileName

string

Name of the file.

fileContent

string

Required

Content of the file. If the contract's source code was flattened before verification, this may be the entire source code.

functions

array of objects

Required

Functions supported by this contract. Parsed from abi_json.

Show 5 properties

name

string

stateMutability

string

type

string

Required

inputs

array of objects

Show 5 properties

components

array of strings, numbers, booleans

option 1: string

option 2: number

option 3: boolean

indexed

boolean

name

string

type

string

flattenedType

string

outputs

array of objects

Show 5 properties

components

array of strings, numbers, booleans

option 1: string

option 2: number

option 3: boolean

indexed

boolean

name

string

type

string

flattenedType

string

events

array of objects

Required

Events this contract can emit. Parsed from abi_json.

Show 4 properties

name

string

type

string

Required

anonymous

boolean

inputs

array of objects

Show 5 properties

components

array of strings, numbers, booleans

option 1: string

option 2: number

option 3: boolean

indexed

boolean

name

string

type

string

flattenedType

string

implementationContract

object

Object of the implementation contract.

Error

Example

1const response = await client.listContracts({
2  blockchain: 'MATIC-AMOY',
3  status: 'COMPLETE',
4  contractInputType: 'IMPORT',
5})
6console.log(response.data)

ResponseChoose an example

1{
2  "data": {
3    "contracts": [
4      {
5        "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
6        "deployerWalletID": "f39e3dbd-84af-4d3d-b5ac-98fbe047ce6a",
7        "deploymentTransactionId": "00ca46f3-c31b-4e3a-92a9-068d4ff26a63",
8        "txHash": "0x4a25cc5e661d8504b59c5f38ba93f010e8518966f00e2ceda7955c4b8621357d",
9        "abiJson": "[{\"inputs\": [],\"stateMutability\": \"nonpayable\",\"type\": \"constructor\"},...",
10        "archived": false,
11        "blockchain": "MATIC-AMOY",
12        "bytecode": "0x60806040523480156200001157600080fd5b50604051806040...",
13        "contractAddress": "0x1e124d7384cd34448ea5907bd0052a79355ab5eb",
14        "contractInputType": "IMPORT",
15        "deployerAddress": "0x1bf9ad0cc2ad298c69a2995aa806ee832788218c",
16        "deployerUserID": "",
17        "deploymentErrorReason": "",
18        "deploymentErrorDetails": "",
19        "name": "First Contract",
20        "description": "My first hello world contract",
21        "status": "PENDING",
22        "verificationStatus": "UNVERIFIED",
23        "metadataLink": "https://ipfs.io/ipfs/Qme7ss3ARVgxv6rXqVPiikMJ8u2NLgmgszg13pYrDKEoiu",
24        "updateDate": "2023-01-01T12:04:05Z",
25        "createDate": "2023-01-01T12:04:05Z",
26        "sourceCode": [
27          {
28            "fileName": "openzeppelin-solidity/contracts/math/SafeMath.sol",
29            "fileContent": "pragma solidity ^0.4.24;\n\n/**\n * @title SafeMath\n * @dev Math operations with safety checks..."
30          }
31        ],
32        "functions": [
33          {
34            "name": "approve",
35            "stateMutability": "nonpayable",
36            "type": "function",
37            "inputs": [
38              {
39                "components": [],
40                "indexed": false,
41                "name": "to",
42                "type": "address",
43                "flattenedType": ""
44              }
45            ],
46            "outputs": [
47              {
48                "components": [],
49                "indexed": false,
50                "name": "to",
51                "type": "address",
52                "flattenedType": ""
53              }
54            ]
55          }
56        ],
57        "events": [
58          {
59            "name": "Approval",
60            "type": "event",
61            "anonymous": false,
62            "inputs": [
63              {
64                "components": [],
65                "indexed": false,
66                "name": "to",
67                "type": "address",
68                "flattenedType": ""
69              }
70            ]
71          }
72        ],
73        "implementationContract": {}
74      }
75    ]
76  }
77}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy