Skip to content

创建文章

We are looking for publications that demonstrate building dApps or smart contracts!
See the full list of Gitcoin bounties that are eligible for rewards.

indexer


Paths

GET /health

Returns 200 if healthy.

GET /health

Responses

HTTP Code Description Schema
200 (empty) HealthCheck
default Unknown Error No Content

Produces

  • application/json

Tags

  • common

GET /v2/accounts

Description Search for accounts.

Parameters

Type Name Description Schema
Query application-id
optional
Application ID integer
Query asset-id
optional
Asset ID integer
Query auth-addr
optional
Include accounts configured to use this spending key. string
Query currency-greater-than
optional
Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query currency-less-than
optional
Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query exclude
optional
Exclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account. < enum (all, assets, created-assets, apps-local-state, created-apps, none) > array
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string
Query round
optional
Deprecated and disallowed. This parameter used to include results for a specified round. Requests with this parameter set are now rejected. integer

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
500 Response for errors Response 500

Response 200

Name Description Schema
accounts
required
< Account > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • search

GET /v2/accounts/{account-id}

Description Lookup account information.

Parameters

Type Name Description Schema
Path account-id
required
account string string
Query exclude
optional
Exclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account. < enum (all, assets, created-assets, apps-local-state, created-apps, none) > array
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query round
optional
Deprecated and disallowed. This parameter used to include results for a specified round. Requests with this parameter set are now rejected. integer

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
account
required
Account
current-round
required
Round at which the results were computed. integer

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/accounts/{account-id}/apps-local-state

Description Lookup an account's asset holdings, optionally for a specific ID.

Parameters

Type Name Description Schema
Path account-id
required
account string string
Query application-id
optional
Application ID integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
apps-local-states
required
< ApplicationLocalState > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/accounts/{account-id}/assets

Description Lookup an account's asset holdings, optionally for a specific ID.

Parameters

Type Name Description Schema
Path account-id
required
account string string
Query asset-id
optional
Asset ID integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
assets
required
< AssetHolding > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/accounts/{account-id}/created-applications

Description Lookup an account's created application parameters, optionally for a specific ID.

Parameters

Type Name Description Schema
Path account-id
required
account string string
Query application-id
optional
Application ID integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
applications
required
< Application > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/accounts/{account-id}/created-assets

Description Lookup an account's created asset parameters, optionally for a specific ID.

Parameters

Type Name Description Schema
Path account-id
required
account string string
Query asset-id
optional
Asset ID integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
assets
required
< Asset > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/accounts/{account-id}/transactions

Description Lookup account transactions. Transactions are returned newest to oldest.

Parameters

Type Name Description Schema
Path account-id
required
account string string
Query after-time
optional
Include results after the given time. Must be an RFC 3339 formatted string. string (date-time)
Query asset-id
optional
Asset ID integer
Query before-time
optional
Include results before the given time. Must be an RFC 3339 formatted string. string (date-time)
Query currency-greater-than
optional
Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query currency-less-than
optional
Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query max-round
optional
Include results at or before the specified max-round. integer
Query min-round
optional
Include results at or after the specified min-round. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string
Query note-prefix
optional
Specifies a prefix which must be contained in the note field. string
Query rekey-to
optional
Include results which include the rekey-to field. boolean
Query round
optional
Include results for the specified round. integer
Query sig-type
optional
SigType filters just results using the specified type of signature:
* sig - Standard
* msig - MultiSig
* lsig - LogicSig
enum (sig, msig, lsig)
Query tx-type
optional
enum (pay, keyreg, acfg, axfer, afrz, appl, stpf)
Query txid
optional
Lookup the specific transaction by ID. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
500 Response for errors Response 500

Response 200

Name Description Schema
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string
transactions
required
< Transaction > array

Response 400

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/applications

Description Search for applications

Parameters

Type Name Description Schema
Query application-id
optional
Application ID integer
Query creator
optional
Filter just applications with the given creator address. string
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
500 Response for errors Response 500

Response 200

Name Description Schema
applications
required
< Application > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • search

GET /v2/applications/{application-id}

Description Lookup application.

Parameters

Type Name Description Schema
Path application-id
required
integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean

Responses

HTTP Code Description Schema
200 (empty) Response 200
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
application
optional
Application
current-round
required
Round at which the results were computed. integer

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/applications/{application-id}/box

Get box information for a given application.

GET /v2/applications/{application-id}/box

Description Given an application ID and box name, returns base64 encoded box name and value. Box names must be in the goal app call arg form 'encoding:value'. For ints, use the form 'int:1234'. For raw bytes, encode base 64 and use 'b64' prefix as in 'b64:A=='. For printable strings, use the form 'str:hello'. For addresses, use the form 'addr:XYZ...'.

Parameters

Type Name Description Schema
Path application-id
required
integer
Query name
required
A box name in goal-arg form 'encoding:value'. For ints, use the form 'int:1234'. For raw bytes, use the form 'b64:A=='. For printable strings, use the form 'str:hello'. For addresses, use the form 'addr:XYZ...'. string

Responses

HTTP Code Description Schema
200 Box information Box
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/applications/{application-id}/boxes

Get box names for a given application.

GET /v2/applications/{application-id}/boxes

Description Given an application ID, returns the box names of that application sorted lexicographically.

Parameters

Type Name Description Schema
Path application-id
required
integer
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 Box names of an application Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
application-id
required
[appidx] application index. integer
boxes
required
< BoxDescriptor > array
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • search

GET /v2/applications/{application-id}/logs

Description Lookup application logs.

Parameters

Type Name Description Schema
Path application-id
required
integer
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query max-round
optional
Include results at or before the specified max-round. integer
Query min-round
optional
Include results at or after the specified min-round. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string
Query sender-address
optional
Only include transactions with this sender address. string
Query txid
optional
Lookup the specific transaction by ID. string

Responses

HTTP Code Description Schema
200 (empty) Response 200

Response 200

Name Description Schema
application-id
required
[appidx] application index. integer
current-round
required
Round at which the results were computed. integer
log-data
optional
< ApplicationLogData > array
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/assets

Description Search for assets.

Parameters

Type Name Description Schema
Query asset-id
optional
Asset ID integer
Query creator
optional
Filter just assets with the given creator address. string
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query name
optional
Filter just assets with the given name. string
Query next
optional
The next page of results. Use the next token provided by the previous results. string
Query unit
optional
Filter just assets with the given unit. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
500 Response for errors Response 500

Response 200

Name Description Schema
assets
required
< Asset > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • search

GET /v2/assets/{asset-id}

Description Lookup asset information.

Parameters

Type Name Description Schema
Path asset-id
required
integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
asset
required
Asset
current-round
required
Round at which the results were computed. integer

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/assets/{asset-id}/balances

Description Lookup the list of accounts who hold this asset

Parameters

Type Name Description Schema
Path asset-id
required
integer
Query currency-greater-than
optional
Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query currency-less-than
optional
Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query include-all
optional
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
500 Response for errors Response 500

Response 200

Name Description Schema
balances
required
< MiniAssetHolding > array
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string

Response 400

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/assets/{asset-id}/transactions

Description Lookup transactions for an asset. Transactions are returned oldest to newest.

Parameters

Type Name Description Schema
Path asset-id
required
integer
Query address
optional
Only include transactions with this address in one of the transaction fields. string
Query address-role
optional
Combine with the address parameter to define what type of address to search for. enum (sender, receiver, freeze-target)
Query after-time
optional
Include results after the given time. Must be an RFC 3339 formatted string. string (date-time)
Query before-time
optional
Include results before the given time. Must be an RFC 3339 formatted string. string (date-time)
Query currency-greater-than
optional
Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query currency-less-than
optional
Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query exclude-close-to
optional
Combine with address and address-role parameters to define what type of address to search for. The close to fields are normally treated as a receiver, if you would like to exclude them set this parameter to true. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query max-round
optional
Include results at or before the specified max-round. integer
Query min-round
optional
Include results at or after the specified min-round. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string
Query note-prefix
optional
Specifies a prefix which must be contained in the note field. string
Query rekey-to
optional
Include results which include the rekey-to field. boolean
Query round
optional
Include results for the specified round. integer
Query sig-type
optional
SigType filters just results using the specified type of signature:
* sig - Standard
* msig - MultiSig
* lsig - LogicSig
enum (sig, msig, lsig)
Query tx-type
optional
enum (pay, keyreg, acfg, axfer, afrz, appl, stpf)
Query txid
optional
Lookup the specific transaction by ID. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
500 Response for errors Response 500

Response 200

Name Description Schema
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string
transactions
required
< Transaction > array

Response 400

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/blocks/{round-number}

Description Lookup block.

Parameters

Type Name Description Schema
Path round-number
required
Round number integer
Query header-only
optional
Header only flag. When this is set to true, returned block does not contain the transactions boolean

Responses

HTTP Code Description Schema
200 (empty) Block
404 Response for errors Response 404
500 Response for errors Response 500

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

GET /v2/transactions

Description Search for transactions. Transactions are returned oldest to newest unless the address parameter is used, in which case results are returned newest to oldest.

Parameters

Type Name Description Schema
Query address
optional
Only include transactions with this address in one of the transaction fields. string
Query address-role
optional
Combine with the address parameter to define what type of address to search for. enum (sender, receiver, freeze-target)
Query after-time
optional
Include results after the given time. Must be an RFC 3339 formatted string. string (date-time)
Query application-id
optional
Application ID integer
Query asset-id
optional
Asset ID integer
Query before-time
optional
Include results before the given time. Must be an RFC 3339 formatted string. string (date-time)
Query currency-greater-than
optional
Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query currency-less-than
optional
Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used. integer
Query exclude-close-to
optional
Combine with address and address-role parameters to define what type of address to search for. The close to fields are normally treated as a receiver, if you would like to exclude them set this parameter to true. boolean
Query limit
optional
Maximum number of results to return. There could be additional pages even if the limit is not reached. integer
Query max-round
optional
Include results at or before the specified max-round. integer
Query min-round
optional
Include results at or after the specified min-round. integer
Query next
optional
The next page of results. Use the next token provided by the previous results. string
Query note-prefix
optional
Specifies a prefix which must be contained in the note field. string
Query rekey-to
optional
Include results which include the rekey-to field. boolean
Query round
optional
Include results for the specified round. integer
Query sig-type
optional
SigType filters just results using the specified type of signature:
* sig - Standard
* msig - MultiSig
* lsig - LogicSig
enum (sig, msig, lsig)
Query tx-type
optional
enum (pay, keyreg, acfg, axfer, afrz, appl, stpf)
Query txid
optional
Lookup the specific transaction by ID. string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
500 Response for errors Response 500

Response 200

Name Description Schema
current-round
required
Round at which the results were computed. integer
next-token
optional
Used for pagination, when making another request provide this token with the next parameter. string
transactions
required
< Transaction > array

Response 400

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • search

GET /v2/transactions/{txid}

Description Lookup a single transaction.

Parameters

Type Name Schema
Path txid
required
string

Responses

HTTP Code Description Schema
200 (empty) Response 200
400 Response for errors Response 400
404 Response for errors Response 404
500 Response for errors Response 500

Response 200

Name Description Schema
current-round
required
Round at which the results were computed. integer
transaction
required
Transaction

Response 400

Name Schema
data
optional
object
message
required
string

Response 404

Name Schema
data
optional
object
message
required
string

Response 500

Name Schema
data
optional
object
message
required
string

Consumes

  • application/json

Produces

  • application/json

Tags

  • lookup

Definitions

Account

Account information at a given round.

Definition: data/basics/userBalance.go : AccountData

Name Description Schema
address
required
the account public key string
amount
required
total number of MicroAlgos in the account integer
amount-without-pending-rewards
required
specifies the amount of MicroAlgos in the account, without the pending rewards. integer
apps-local-state
optional
application local data stored in this account.

Note the raw object uses map[int] -> AppLocalState for this type.
< ApplicationLocalState > array
apps-total-extra-pages
optional
the sum of all extra application program pages for this account. integer
apps-total-schema
optional
the sum of all of the local schemas and global schemas in this account.

Note: the raw account uses StateSchema for this type.
ApplicationStateSchema
assets
optional
assets held by this account.

Note the raw object uses map[int] -> AssetHolding for this type.
< AssetHolding > array
auth-addr
optional
The address against which signing should be checked. If empty, the address of the current account is used. This field can be updated in any transaction by setting the RekeyTo field. string
closed-at-round
optional
Round during which this account was most recently closed. integer
created-apps
optional
parameters of applications created by this account including app global data.

Note: the raw account uses map[int] -> AppParams for this type.
< Application > array
created-assets
optional
parameters of assets created by this account.

Note: the raw account uses map[int] -> Asset for this type.
< Asset > array
created-at-round
optional
Round during which this account first appeared in a transaction. integer
deleted
optional
Whether or not this account is currently closed. boolean
incentive-eligible
optional
can the account receive block incentives if its balance is in range at proposal time. boolean
last-heartbeat
optional
The round in which this account last went online, or explicitly renewed their online status. integer
last-proposed
optional
The round in which this account last proposed the block. integer
min-balance
required
MicroAlgo balance required by the account.

The requirement grows based on asset and application usage.
integer
participation
optional
AccountParticipation
pending-rewards
required
amount of MicroAlgos of pending rewards in this account. integer
reward-base
optional
used as part of the rewards computation. Only applicable to accounts which are participating. integer
rewards
required
total rewards of MicroAlgos the account has received, including pending rewards. integer
round
required
The round for which this information is relevant. integer
sig-type
optional
the type of signature used by this account, must be one of:
* sig
* msig
* lsig
* or null if unknown
enum (sig, msig, lsig)
status
required
voting status of the account's MicroAlgos
* Offline - indicates that the associated account is delegated.
* Online - indicates that the associated account used as part of the delegation pool.
* NotParticipating - indicates that the associated account is neither a delegator nor a delegate.
string
total-apps-opted-in
required
The count of all applications that have been opted in, equivalent to the count of application local data (AppLocalState objects) stored in this account. integer
total-assets-opted-in
required
The count of all assets that have been opted in, equivalent to the count of AssetHolding objects held by this account. integer
total-box-bytes
required
For app-accounts only. The total number of bytes allocated for the keys and values of boxes which belong to the associated application. integer
total-boxes
required
For app-accounts only. The total number of boxes which belong to the associated application. integer
total-created-apps
required
The count of all apps (AppParams objects) created by this account. integer
total-created-assets
required
The count of all assets (AssetParams objects) created by this account. integer

AccountParticipation

AccountParticipation describes the parameters used by this account in consensus protocol.

Name Description Schema
selection-participation-key
required
Selection public key (if any) currently registered for this round.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
state-proof-key
optional
Root of the state proof key (if any)
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
vote-first-valid
required
First round for which this participation is valid. integer
vote-key-dilution
required
Number of subkeys in each batch of participation keys. integer
vote-last-valid
required
Last round for which this participation is valid. integer
vote-participation-key
required
root participation public key (if any) currently registered for this round.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

AccountStateDelta

Application state delta.

Name Schema
address
required
string
delta
required
StateDelta

Application

Application index and its parameters

Name Description Schema
created-at-round
optional
Round when this application was created. integer
deleted
optional
Whether or not this application is currently deleted. boolean
deleted-at-round
optional
Round when this application was deleted. integer
id
required
application index. integer
params
required
application parameters. ApplicationParams

ApplicationLocalState

Stores local state associated with an application.

Name Description Schema
closed-out-at-round
optional
Round when account closed out of the application. integer
deleted
optional
Whether or not the application local state is currently deleted from its account. boolean
id
required
The application which this local state is for. integer
key-value
optional
storage. TealKeyValueStore
opted-in-at-round
optional
Round when the account opted into the application. integer
schema
required
schema. ApplicationStateSchema

ApplicationLogData

Stores the global information associated with an application.

Name Description Schema
logs
required
Logs for the application being executed by the transaction. < string (byte) > array
txid
required
Transaction ID string

ApplicationParams

Stores the global information associated with an application.

Name Description Schema
approval-program
required
approval program.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
clear-state-program
required
clear state program.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
creator
optional
The address that created this application. This is the address where the parameters and global state for this application can be found. string
extra-program-pages
optional
the number of extra program pages available to this app. integer
global-state
optional
global state TealKeyValueStore
global-state-schema
optional
global schema ApplicationStateSchema
local-state-schema
optional
local schema ApplicationStateSchema

ApplicationStateSchema

Specifies maximums on the number of each type that may be stored.

Name Description Schema
num-byte-slice
required
number of byte slices. integer
num-uint
required
number of uints. integer

Asset

Specifies both the unique identifier and the parameters for an asset

Name Description Schema
created-at-round
optional
Round during which this asset was created. integer
deleted
optional
Whether or not this asset is currently deleted. boolean
destroyed-at-round
optional
Round during which this asset was destroyed. integer
index
required
unique asset identifier integer
params
required
AssetParams

AssetHolding

Describes an asset held by an account.

Definition: data/basics/userBalance.go : AssetHolding

Name Description Schema
amount
required
number of units held. integer
asset-id
required
Asset ID of the holding. integer
deleted
optional
Whether or not the asset holding is currently deleted from its account. boolean
is-frozen
required
whether or not the holding is frozen. boolean
opted-in-at-round
optional
Round during which the account opted into this asset holding. integer
opted-out-at-round
optional
Round during which the account opted out of this asset holding. integer

AssetParams

AssetParams specifies the parameters for an asset.

[apar] when part of an AssetConfig transaction.

Definition: data/transactions/asset.go : AssetParams

Name Description Schema
clawback
optional
Address of account used to clawback holdings of this asset. If empty, clawback is not permitted. string
creator
required
The address that created this asset. This is the address where the parameters for this asset can be found, and also the address where unwanted asset units can be sent in the worst case. string
decimals
required
The number of digits to use after the decimal point when displaying this asset. If 0, the asset is not divisible. If 1, the base unit of the asset is in tenths. If 2, the base unit of the asset is in hundredths, and so on. This value must be between 0 and 19 (inclusive).
Minimum value : 0
Maximum value : 19
integer
default-frozen
optional
Whether holdings of this asset are frozen by default. boolean
freeze
optional
Address of account used to freeze holdings of this asset. If empty, freezing is not permitted. string
manager
optional
Address of account used to manage the keys of this asset and to destroy it. string
metadata-hash
optional
A commitment to some unspecified asset metadata. The format of this metadata is up to the application.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
name
optional
Name of this asset, as supplied by the creator. Included only when the asset name is composed of printable utf-8 characters. string
name-b64
optional
Base64 encoded name of this asset, as supplied by the creator.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
reserve
optional
Address of account holding reserve (non-minted) units of this asset. string
total
required
The total number of units of this asset. integer
unit-name
optional
Name of a unit of this asset, as supplied by the creator. Included only when the name of a unit of this asset is composed of printable utf-8 characters. string
unit-name-b64
optional
Base64 encoded name of a unit of this asset, as supplied by the creator.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
url
optional
URL where more information about the asset can be retrieved. Included only when the URL is composed of printable utf-8 characters. string
url-b64
optional
Base64 encoded URL where more information about the asset can be retrieved.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

Block

Block information.

Definition: data/bookkeeping/block.go : Block

Name Description Schema
bonus
optional
the potential bonus payout for this block. integer
fees-collected
optional
the sum of all fees paid by transactions in this block. integer
genesis-hash
required
[gh] hash to which this block belongs.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
genesis-id
required
[gen] ID to which this block belongs. string
participation-updates
optional
ParticipationUpdates
previous-block-hash
required
[prev] Previous block hash.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
proposer
optional
the proposer of this block. string
proposer-payout
optional
the actual amount transferred to the proposer from the fee sink. integer
rewards
optional
BlockRewards
round
required
[rnd] Current round on which this block was appended to the chain. integer
seed
required
[seed] Sortition seed.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
state-proof-tracking
optional
Tracks the status of state proofs. < StateProofTracking > array
timestamp
required
[ts] Block creation timestamp in seconds since eposh integer
transactions
optional
[txns] list of transactions corresponding to a given round. < Transaction > array
transactions-root
required
[txn] TransactionsRoot authenticates the set of transactions appearing in the block. More specifically, it's the root of a merkle tree whose leaves are the block's Txids, in lexicographic order. For the empty block, it's 0. Note that the TxnRoot does not authenticate the signatures on the transactions, only the transactions themselves. Two blocks with the same transactions but in a different order and with different signatures will have the same TxnRoot.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
transactions-root-sha256
required
[txn256] TransactionsRootSHA256 is an auxiliary TransactionRoot, built using a vector commitment instead of a merkle tree, and SHA256 hash function instead of the default SHA512_256. This commitment can be used on environments where only the SHA256 function exists.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
txn-counter
optional
[tc] TxnCounter counts the number of transactions committed in the ledger, from the time at which support for this feature was introduced.

Specifically, TxnCounter is the number of the next transaction that will be committed after this block. It is 0 when no transactions have ever been committed (since TxnCounter started being supported).
integer
upgrade-state
optional
BlockUpgradeState
upgrade-vote
optional
BlockUpgradeVote

BlockRewards

Fields relating to rewards,

Name Description Schema
fee-sink
required
[fees] accepts transaction fees, it can only spend to the incentive pool. string
rewards-calculation-round
required
[rwcalr] number of leftover MicroAlgos after the distribution of rewards-rate MicroAlgos for every reward unit in the next round. integer
rewards-level
required
[earn] How many rewards, in MicroAlgos, have been distributed to each RewardUnit of MicroAlgos since genesis. integer
rewards-pool
required
[rwd] accepts periodic injections from the fee-sink and continually redistributes them as rewards. string
rewards-rate
required
[rate] Number of new MicroAlgos added to the participation stake from rewards at the next round. integer
rewards-residue
required
[frac] Number of leftover MicroAlgos after the distribution of RewardsRate/rewardUnits MicroAlgos for every reward unit in the next round. integer

BlockUpgradeState

Fields relating to a protocol upgrade.

Name Description Schema
current-protocol
required
[proto] The current protocol version. string
next-protocol
optional
[nextproto] The next proposed protocol version. string
next-protocol-approvals
optional
[nextyes] Number of blocks which approved the protocol upgrade. integer
next-protocol-switch-on
optional
[nextswitch] Round on which the protocol upgrade will take effect. integer
next-protocol-vote-before
optional
[nextbefore] Deadline round for this protocol upgrade (No votes will be consider after this round). integer

BlockUpgradeVote

Fields relating to voting for a protocol upgrade.

Name Description Schema
upgrade-approve
optional
[upgradeyes] Indicates a yes vote for the current proposal. boolean
upgrade-delay
optional
[upgradedelay] Indicates the time between acceptance and execution. integer
upgrade-propose
optional
[upgradeprop] Indicates a proposed upgrade. string

Box

Box name and its content.

Name Description Schema
name
required
[name] box name, base64 encoded
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
round
required
The round for which this information is relevant integer
value
required
[value] box value, base64 encoded.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

BoxDescriptor

Box descriptor describes an app box without a value.

Name Description Schema
name
required
Base64 encoded box name
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

EvalDelta

Represents a TEAL value delta.

Name Description Schema
action
required
[at] delta action. integer
bytes
optional
[bs] bytes value. string
uint
optional
[ui] uint value. integer

EvalDeltaKeyValue

Key-value pairs for StateDelta.

Name Schema
key
required
string
value
required
EvalDelta

HashFactory

Name Description Schema
hash-type
optional
[t] integer

Hashtype

The type of hash function used to create the proof, must be one of: * sha512_256 * sha256

Type : enum (sha512_256, sha256)

HealthCheck

A health check response.

Name Description Schema
data
optional
object
db-available
required
boolean
errors
optional
< string > array
is-migrating
required
boolean
message
required
string
round
required
integer
version
required
Current version. string

IndexerStateProofMessage

Name Description Schema
block-headers-commitment
optional
[b]
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
first-attested-round
optional
[f] integer
latest-attested-round
optional
[l] integer
ln-proven-weight
optional
[P] integer
voters-commitment
optional
[v]
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

MerkleArrayProof

Name Description Schema
hash-factory
optional
HashFactory
path
optional
[pth] < string (byte) > array
tree-depth
optional
[td] integer

MiniAssetHolding

A simplified version of AssetHolding

Name Description Schema
address
required
string
amount
required
integer
deleted
optional
Whether or not this asset holding is currently deleted from its account. boolean
is-frozen
required
boolean
opted-in-at-round
optional
Round during which the account opted into the asset. integer
opted-out-at-round
optional
Round during which the account opted out of the asset. integer

OnCompletion

[apan] defines the what additional actions occur with the transaction.

Valid types: * noop * optin * closeout * clear * update * update * delete

Type : enum (noop, optin, closeout, clear, update, delete)

ParticipationUpdates

Participation account data that needs to be checked/acted on by the network.

Name Description Schema
absent-participation-accounts
optional
[partupabs] a list of online accounts that need to be suspended. < string > array
expired-participation-accounts
optional
[partupdrmv] a list of online accounts that needs to be converted to offline since their participation key expired. < string > array

StateDelta

Application state delta.

Type : < EvalDeltaKeyValue > array

StateProofFields

[sp] represents a state proof.

Definition: crypto/stateproof/structs.go : StateProof

Name Description Schema
part-proofs
optional
[P] MerkleArrayProof
positions-to-reveal
optional
[pr] Sequence of reveal positions. < integer > array
reveals
optional
[r] Note that this is actually stored as a map[uint64] - Reveal in the actual msgp < StateProofReveal > array
salt-version
optional
[v] Salt version of the merkle signature. integer
sig-commit
optional
[c]
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
sig-proofs
optional
[S] MerkleArrayProof
signed-weight
optional
[w] integer

StateProofParticipant

Name Description Schema
verifier
optional
[p] StateProofVerifier
weight
optional
[w] integer

StateProofReveal

Name Description Schema
participant
optional
[p] StateProofParticipant
position
optional
The position in the signature and participants arrays corresponding to this entry. integer
sig-slot
optional
[s] StateProofSigSlot

StateProofSigSlot

Name Description Schema
lower-sig-weight
optional
[l] The total weight of signatures in the lower-numbered slots. integer
signature
optional
StateProofSignature

StateProofSignature

Name Description Schema
falcon-signature
optional
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$" string (byte)
merkle-array-index
optional
integer
proof
optional
MerkleArrayProof
verifying-key
optional
[vkey]
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

StateProofTracking

Name Description Schema
next-round
optional
[n] Next round for which we will accept a state proof transaction. integer
online-total-weight
optional
[t] The total number of microalgos held by the online accounts during the StateProof round. integer
type
optional
State Proof Type. Note the raw object uses map with this as key. integer
voters-commitment
optional
[v] Root of a vector commitment containing online accounts that will help sign the proof.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

StateProofVerifier

Name Description Schema
commitment
optional
[cmt] Represents the root of the vector commitment tree.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
key-lifetime
optional
[lf] Key lifetime. integer

StateSchema

Represents a [apls] local-state or [apgs] global-state schema. These schemas determine how much storage may be used in a local-state or global-state for an application. The more space used, the larger minimum balance must be maintained in the account holding the data.

Name Description Schema
num-byte-slice
required
Maximum number of TEAL byte slices that may be stored in the key/value store. integer
num-uint
required
Maximum number of TEAL uints that may be stored in the key/value store. integer

TealKeyValue

Represents a key-value pair in an application store.

Name Schema
key
required
string
value
required
TealValue

TealKeyValueStore

Represents a key-value store for use in an application.

Type : < TealKeyValue > array

TealValue

Represents a TEAL value.

Name Description Schema
bytes
required
bytes value. string
type
required
type of the value. Value 1 refers to bytes, value 2 refers to uint integer
uint
required
uint value. integer

Transaction

Contains all fields common to all transactions and serves as an envelope to all transactions type. Represents both regular and inner transactions.

Definition: data/transactions/signedtxn.go : SignedTxn data/transactions/transaction.go : Transaction

Name Description Schema
application-transaction
optional
TransactionApplication
asset-config-transaction
optional
TransactionAssetConfig
asset-freeze-transaction
optional
TransactionAssetFreeze
asset-transfer-transaction
optional
TransactionAssetTransfer
auth-addr
optional
[sgnr] this is included with signed transactions when the signing address does not equal the sender. The backend can use this to ensure that auth addr is equal to the accounts auth addr. string
close-rewards
optional
[rc] rewards applied to close-remainder-to account. integer
closing-amount
optional
[ca] closing amount for transaction. integer
confirmed-round
optional
Round when the transaction was confirmed. integer
created-application-index
optional
Specifies an application index (ID) if an application was created with this transaction. integer
created-asset-index
optional
Specifies an asset index (ID) if an asset was created with this transaction. integer
fee
required
[fee] Transaction fee. integer
first-valid
required
[fv] First valid round for this transaction. integer
genesis-hash
optional
[gh] Hash of genesis block.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
genesis-id
optional
[gen] genesis block ID. string
global-state-delta
optional
[gd] Global state key/value changes for the application being executed by this transaction. StateDelta
group
optional
[grp] Base64 encoded byte array of a sha512/256 digest. When present indicates that this transaction is part of a transaction group and the value is the sha512/256 hash of the transactions in that group.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
id
optional
Transaction ID string
inner-txns
optional
Inner transactions produced by application execution. < Transaction > array
intra-round-offset
optional
Offset into the round where this transaction was confirmed. integer
keyreg-transaction
optional
TransactionKeyreg
last-valid
required
[lv] Last valid round for this transaction. integer
lease
optional
[lx] Base64 encoded 32-byte array. Lease enforces mutual exclusion of transactions. If this field is nonzero, then once the transaction is confirmed, it acquires the lease identified by the (Sender, Lease) pair of the transaction until the LastValid round passes. While this transaction possesses the lease, no other transaction specifying this lease can be confirmed.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
local-state-delta
optional
[ld] Local state key/value changes for the application being executed by this transaction. < AccountStateDelta > array
logs
optional
[lg] Logs for the application being executed by this transaction. < string (byte) > array
note
optional
[note] Free form data.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
payment-transaction
optional
TransactionPayment
receiver-rewards
optional
[rr] rewards applied to receiver account. integer
rekey-to
optional
[rekey] when included in a valid transaction, the accounts auth addr will be updated with this value and future signatures must be signed with the key represented by this address. string
round-time
optional
Time when the block this transaction is in was confirmed. integer
sender
required
[snd] Sender's address. string
sender-rewards
optional
[rs] rewards applied to sender account. integer
signature
optional
TransactionSignature
state-proof-transaction
optional
TransactionStateProof
tx-type
required
[type] Indicates what type of transaction this is. Different types have different fields.

Valid types, and where their fields are stored:
* [pay] payment-transaction
* [keyreg] keyreg-transaction
* [acfg] asset-config-transaction
* [axfer] asset-transfer-transaction
* [afrz] asset-freeze-transaction
* [appl] application-transaction
* [stpf] state-proof-transaction
enum (pay, keyreg, acfg, axfer, afrz, appl, stpf)

TransactionApplication

Fields for application transactions.

Definition: data/transactions/application.go : ApplicationCallTxnFields

Name Description Schema
accounts
optional
[apat] List of accounts in addition to the sender that may be accessed from the application's approval-program and clear-state-program. < string > array
application-args
optional
[apaa] transaction specific arguments accessed from the application's approval-program and clear-state-program. < string > array
application-id
required
[apid] ID of the application being configured or empty if creating. integer
approval-program
optional
[apap] Logic executed for every application transaction, except when on-completion is set to "clear". It can read and write global state for the application, as well as account-specific local state. Approval programs may reject the transaction.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
clear-state-program
optional
[apsu] Logic executed for application transactions with on-completion set to "clear". It can read and write global state for the application, as well as account-specific local state. Clear state programs cannot reject the transaction.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
extra-program-pages
optional
[epp] specifies the additional app program len requested in pages. integer
foreign-apps
optional
[apfa] Lists the applications in addition to the application-id whose global states may be accessed by this application's approval-program and clear-state-program. The access is read-only. < integer > array
foreign-assets
optional
[apas] lists the assets whose parameters may be accessed by this application's ApprovalProgram and ClearStateProgram. The access is read-only. < integer > array
global-state-schema
optional
StateSchema
local-state-schema
optional
StateSchema
on-completion
required
OnCompletion

TransactionAssetConfig

Fields for asset allocation, re-configuration, and destruction.

A zero value for asset-id indicates asset creation. A zero value for the params indicates asset destruction.

Definition: data/transactions/asset.go : AssetConfigTxnFields

Name Description Schema
asset-id
optional
[xaid] ID of the asset being configured or empty if creating. integer
params
optional
AssetParams

TransactionAssetFreeze

Fields for an asset freeze transaction.

Definition: data/transactions/asset.go : AssetFreezeTxnFields

Name Description Schema
address
required
[fadd] Address of the account whose asset is being frozen or thawed. string
asset-id
required
[faid] ID of the asset being frozen or thawed. integer
new-freeze-status
required
[afrz] The new freeze status. boolean

TransactionAssetTransfer

Fields for an asset transfer transaction.

Definition: data/transactions/asset.go : AssetTransferTxnFields

Name Description Schema
amount
required
[aamt] Amount of asset to transfer. A zero amount transferred to self allocates that asset in the account's Assets map. integer
asset-id
required
[xaid] ID of the asset being transferred. integer
close-amount
optional
Number of assets transferred to the close-to account as part of the transaction. integer
close-to
optional
[aclose] Indicates that the asset should be removed from the account's Assets map, and specifies where the remaining asset holdings should be transferred. It's always valid to transfer remaining asset holdings to the creator account. string
receiver
required
[arcv] Recipient address of the transfer. string
sender
optional
[asnd] The effective sender during a clawback transactions. If this is not a zero value, the real transaction sender must be the Clawback address from the AssetParams. string

TransactionKeyreg

Fields for a keyreg transaction.

Definition: data/transactions/keyreg.go : KeyregTxnFields

Name Description Schema
non-participation
optional
[nonpart] Mark the account as participating or non-participating. boolean
selection-participation-key
optional
[selkey] Public key used with the Verified Random Function (VRF) result during committee selection.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
state-proof-key
optional
[sprfkey] State proof key used in key registration transactions.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
vote-first-valid
optional
[votefst] First round this participation key is valid. integer
vote-key-dilution
optional
[votekd] Number of subkeys in each batch of participation keys. integer
vote-last-valid
optional
[votelst] Last round this participation key is valid. integer
vote-participation-key
optional
[votekey] Participation public key used in key registration transactions.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

TransactionPayment

Fields for a payment transaction.

Definition: data/transactions/payment.go : PaymentTxnFields

Name Description Schema
amount
required
[amt] number of MicroAlgos intended to be transferred. integer
close-amount
optional
Number of MicroAlgos that were sent to the close-remainder-to address when closing the sender account. integer
close-remainder-to
optional
[close] when set, indicates that the sending account should be closed and all remaining funds be transferred to this address. string
receiver
required
[rcv] receiver's address. string

TransactionSignature

Validation signature associated with some data. Only one of the signatures should be provided.

Name Description Schema
logicsig
optional
TransactionSignatureLogicsig
multisig
optional
TransactionSignatureMultisig
sig
optional
[sig] Standard ed25519 signature.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

TransactionSignatureLogicsig

[lsig] Programatic transaction signature.

Definition: data/transactions/logicsig.go

Name Description Schema
args
optional
[arg] Logic arguments, base64 encoded. < string > array
logic
required
[l] Program signed by a signature or multi signature, or hashed to be the address of ana ccount. Base64 encoded TEAL program.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
multisig-signature
optional
TransactionSignatureMultisig
signature
optional
[sig] ed25519 signature.
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

TransactionSignatureMultisig

[msig] structure holding multiple subsignatures.

Definition: crypto/multisig.go : MultisigSig

Name Description Schema
subsignature
optional
[subsig] holds pairs of public key and signatures. < TransactionSignatureMultisigSubsignature > array
threshold
optional
[thr] integer
version
optional
[v] integer

TransactionSignatureMultisigSubsignature

Name Description Schema
public-key
optional
[pk]
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)
signature
optional
[s]
Pattern : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"
string (byte)

TransactionStateProof

Fields for a state proof transaction.

Definition: data/transactions/stateproof.go : StateProofTxnFields

Name Description Schema
message
optional
[spmsg] IndexerStateProofMessage
state-proof
optional
StateProofFields
state-proof-type
optional
[sptype] Type of the state proof. Integer representing an entry defined in protocol/stateproof.go integer