Scan

GET /scan/search

Search for relevant schemas, attestations, and addresses by providing a keyword and filter.

Query Parameters:

KeyValueType

filter*

attestation

"schema"/"attestation"/"address"

keyword*

0x1

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "queryResult": [
            {
                "type": "attestation",
                "rows": [
                    {
                        "id": "onchain_evm_80001_0x1",
                        "chainType": "evm",
                        "chainId": "80001",
                        "attestationId": "0x1",
                        "attester": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                        "recipients": []
                    },
                    ...
                ],
                "total": 2
            }
        ]
    },
    "message": "ok"
}

Top 10 Schemas

GET /scan/top-schemas

Get the current top 10 schemas from the attestation backend.

Query Parameters:

None

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "rows": [
            {
                "id": "onchain_evm_7001_0x4",
                "mode": "onchain",
                "name": "zeta kyc schema",
                "description": "",
                "registrant": "0x8D10D37BF3c50C9Dd34A4BC70987CD60f8f4a466",
                "chainType": "evm",
                "chainId": "7001",
                "schemaId": "0x4",
                "transactionHash": "0x8736b25a8c7644721791ddc544f39e49418bf1516378aa9386a0b2c47baf6c53",
                "attestationCount": 18
            },
            ...
        ]
    },
    "message": "ok"
}
GET /scan/trending-schemas

Get the top trending schemas from the attestation backend.

Query Parameters:

None

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "rows": [
            {
                "id": "onchain_evm_80001_0x1",
                "mode": "onchain",
                "name": "xxx",
                "description": "",
                "registrant": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                "chainType": "evm",
                "chainId": "80001",
                "schemaId": "0x1",
                "transactionHash": "0x97e69df2e65e97001da22953a4376233d792c50810cf3bff0fff1a14e7374b60",
                "attestationCount": 1
            }
        ]
    },
    "message": "ok"
}

Latest 10 Schemas

GET /scan/latest-attestations

Get the most recently created 10 schemas from the attestation backend.

Query Parameters:

None

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "rows": [
            {
                "id": "onchain_evm_80001_0x21",
                "mode": "onchain",
                "chainType": "evm",
                "chainId": "80001",
                "attestationId": "0x21",
                "schemaId": "0x1",
                "attester": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                "attestTimestamp": "1706065910",
                "recipients": [],
                "schema": {
                    "id": "onchain_evm_80001_0x1",
                    "schemaId": "0x1",
                    "name": "xxx"
                }
            },
            ...
        ]
    },
    "message": "ok"
}

Query Paged Schemas

GET /scan/schemas

Query schemas by providing a keyword. Results may be paged if the query returns many results.

Query Parameters:

KeyValueType

page*

1

number

keyword*

0x1

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "total": 23,
        "rows": [
            {
                "id": "onchain_evm_80001_0x1",
                "mode": "onchain",
                "name": "xxx",
                "description": "",
                "registrant": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                "chainType": "evm",
                "chainId": "80001",
                "schemaId": "0x1",
                "transactionHash": "0x97e69df2e65e97001da22953a4376233d792c50810cf3bff0fff1a14e7374b60",
                "attestationCount": 17,
                "attesterCount": 2,
                "data": [
                    {
                        "name": "name",
                        "type": "string"
                    }
                ]
            },
            ...
        ],
        "page": 1,
        "size": 10
    },
    "message": "ok"
}

Get Schema Info

GET /scan/schemas/{id}

Get the data of a schema by providing the schema ID.

Query Parameters:

id

onchain_evm_80001_0x2

string

* Optional parameters.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "id": "onchain_evm_80001_0x2",
        "mode": "onchain",
        "name": "message",
        "description": "",
        "registrant": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
        "registerTimestamp": 1705483984,
        "chainType": "evm",
        "chainId": "80001",
        "schemaId": "0x2",
        "revocable": true,
        "maxValidFor": 0,
        "transactionHash": "0xb1b7aa7da95aced199551f9fd58944551472027f2a6533bf462c4b435b03c789",
        "data": [
            {
                "name": "message",
                "type": "string"
            }
        ]
    },
    "message": "ok"
}

Query Attestations by Schema

GET /scan/attestations

Get attestations for a schema by providing the relevant schema ID.

Query Parameters:

KeyValueType

schemaId

onchain_evm_80001_0x1

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "total": 17,
        "rows": [
            {
                "id": "onchain_evm_80001_0x21",
                "mode": "onchain",
                "chainType": "evm",
                "chainId": "80001",
                "attestationId": "0x21",
                "schemaId": "0x1",
                "attester": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                "attestTimestamp": "1706065910",
                "recipients": []
            },
            ...
        ],
        "page": 1,
        "size": 10
    },
    "message": "ok"
}

Query Paged Attestations

GET /scan/attestations

Query attestations by providing the fields and a relevant keyword. Results may be paged if the query returns many results.

Query Parameters:

KeyValueType

fields*

detail

"detail"

page*

1

number

keyword*

0x1

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "total": 52,
        "rows": [
            {
                "id": "onchain_evm_80001_0x21",
                "mode": "onchain",
                "chainType": "evm",
                "chainId": "80001",
                "attestationId": "0x21",
                "schemaId": "0x1",
                "attester": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                "attestTimestamp": "1706065910",
                "recipients": [],
                "schema": {
                    "id": "onchain_evm_80001_0x1",
                    "chainType": "evm",
                    "chainId": "80001",
                    "schemaId": "0x1",
                    "name": "xxx"
                }
            },
            ...
        ],
        "page": 1,
        "size": 10
    },
    "message": "ok"
}

Get Attestation Info

GET /scan/attestations/{id}

Get the data of an attestation by providing the attestation ID.

Query Parameters:

KeyValueType

id

onchain_evm_80001_0xd

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "id": "onchain_evm_80001_0xd",
        "mode": "onchain",
        "chainType": "evm",
        "chainId": "80001",
        "attestationId": "0xd",
        "transactionHash": "0x5154a89cc54e30d2d9a0c53aedbebdf1a07e864287d52696af352899bba913fe",
        "indexingValue": "0x059e6B8008d34aC26581fD3ED8378AA93c7941EE",
        "schemaId": "0x1",
        "fullSchemaId": "onchain_evm_80001_0x1",
        "linkedAttestation": "",
        "attester": "0x059e6B8008d34aC26581fD3ED8378AA93c7941EE",
        "attestTimestamp": "1705542705",
        "validUntil": "0",
        "revoked": false,
        "revokeTimestamp": null,
        "revokeReason": null,
        "revokeTransactionHash": "",
        "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000033232320000000000000000000000000000000000000000000000000000000000",
        "dataLocation": "ONCHAIN",
        "recipients": [
            "0x059e6B8008d34aC26581fD3ED8378AA93c7941EE",
            "0x2e6CEFDe38e2363be4CE8497bee68E23004ADfB4"
        ],
        "schema": {
            "id": "onchain_evm_80001_0x1",
            "schemaId": "0x1",
            "name": "xxx",
            "data": [
                {
                    "name": "name",
                    "type": "string"
                }
            ]
        }
    },
    "message": "ok"
}

Get Address Statistics

GET /scan/addresses/{address}/statistics

Get attestation and schema statistics for an address.

Query Parameters:

KeyValueType

address

0x059e6B8008d34aC26581fD3ED8378AA93c7941EE

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "schemaCreated": 6,
        "totalAttestations": 14,
        "attestationCreated": 13,
        "attestationReceived": 3
    },
    "message": "ok"
}

Query Address Schemas

GET /scan/addresses/{address}/schemas

Get a list of schemas that a given address has created.

Query Parameters:

KeyValueType

address

0x059e6B8008d34aC26581fD3ED8378AA93c7941EE

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "total": 12,
        "rows": [
            {
                "id": "onchain_evm_80001_0x4",
                "mode": "onchain",
                "chainType": "evm",
                "chainId": "80001",
                "schemaId": "0x4",
                "transactionHash": "0xe2bb19cfd5d45e20e2cc36cb5c6ef2a947c25fc006a3386a260520646fe35837",
                "name": "message",
                "description": "",
                "revocable": true,
                "maxValidFor": "0",
                "resolver": "0x0000000000000000000000000000000000000000",
                "registerTimestamp": "1705484040",
                "registrant": "0x9854E76134e6D729A633CED51042fF653f04f4C5",
                "data": [
                    {
                        "name": "message",
                        "type": "string"
                    }
                ],
                "extra": null,
                "syncAt": "1705932587177"
            },
            ...
        ],
        "page": 1,
        "size": 10
    },
    "message": "ok"
}

Get Address Attestations

GET /scan/addresses/{address}/attestations

Get a list of addresses that a given address has created.

Query Parameters:

KeyValueType

address

0x059e6B8008d34aC26581fD3ED8378AA93c7941EE

string

* Optional parameter.

Response:

{
    "success": true,
    "statusCode": 200,
    "data": {
        "total": 14,
        "rows": [
            {
                "id": "onchain_evm_80001_0x4",
                "mode": "onchain",
                "chainType": "evm",
                "chainId": "80001",
                "attestationId": "0x4",
                "transactionHash": "0xe0fcf6d8e3fc2040e2fc94395144d15ca43fba75de247f650150772e2692b768",
                "indexingValue": "0x059e6B8008d34aC26581fD3ED8378AA93c7941EE",
                "schemaId": "0x1",
                "fullSchemaId": "onchain_evm_80001_0x1",
                "linkedAttestation": "",
                "attester": "0x059e6B8008d34aC26581fD3ED8378AA93c7941EE",
                "attestTimestamp": "1705485310",
                "validUntil": "0",
                "revoked": false,
                "revokeTimestamp": null,
                "revokeReason": null,
                "revokeTransactionHash": "",
                "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000033232320000000000000000000000000000000000000000000000000000000000",
                "dataLocation": "ONCHAIN",
                "extra": "{}",
                "syncAt": "1705653417309",
                "lastSyncAt": null,
                "recipients": [],
                "schema": {
                    "id": "onchain_evm_80001_0x1",
                    "schemaId": "0x1",
                    "name": "xxx",
                    "description": ""
                }
            },
            ...
        ],
        "page": 1,
        "size": 10
    },
    "message": "ok"
}

Last updated