@silvana-one/api
Index
Functions
- airdropTokens
- burnTokens
- buyTokens
- config
- faucet
- getContractInfo
- getNftInfo
- getNftV2Info
- getNonce
- getProof
- getTokenBalance
- getTokenInfo
- launchNftCollection
- launchToken
- mintNft
- mintTokens
- prove
- redeemTokens
- sellTokens
- sendTransaction
- tokenBid
- tokenOffer
- transferTokens
- txStatus
- updateTokenAdminWhitelist
- updateTokenBidWhitelist
- updateTokenOfferWhitelist
- waitForProofs
- waitForTransaction
- withdrawTokenBid
- withdrawTokenOffer
Type Aliases
- AdvancedNftCollectionAdminData
- AirdropTokensData
- AirdropTokensError
- AirdropTokensErrors
- AirdropTokensResponse
- AirdropTokensResponses
- AirdropTransactionResponse
- BalanceRequestParams
- BalanceResponse
- BurnTokensData
- BurnTokensError
- BurnTokensErrors
- BurnTokensResponse
- BurnTokensResponses
- BuyTokensData
- BuyTokensError
- BuyTokensErrors
- BuyTokensResponse
- BuyTokensResponses
- ClientOptions
- CollectionData
- CollectionInfo
- ContractInfo
- ContractInfoRequest
- ContractProperty
- ContractPropertyType
- DeployedNftCollectionTransactionBaseParams
- DeployedTokenTransactionBaseParams
- ErrorResponse
- FaucetData
- FaucetError
- FaucetErrors
- FaucetParams
- FaucetResponse
- FaucetResponse2
- FaucetResponses
- GetContractInfoData
- GetContractInfoError
- GetContractInfoErrors
- GetContractInfoResponse
- GetContractInfoResponses
- GetNftInfoData
- GetNftInfoError
- GetNftInfoErrors
- GetNftInfoResponse
- GetNftInfoResponses
- GetNftV2InfoData
- GetNftV2InfoError
- GetNftV2InfoErrors
- GetNftV2InfoResponse
- GetNftV2InfoResponses
- GetNonceData
- GetNonceError
- GetNonceErrors
- GetNonceResponse
- GetNonceResponses
- GetProofData
- GetProofError
- GetProofErrors
- GetProofResponse
- GetProofResponses
- GetTokenBalanceData
- GetTokenBalanceError
- GetTokenBalanceErrors
- GetTokenBalanceResponse
- GetTokenBalanceResponses
- GetTokenInfoData
- GetTokenInfoError
- GetTokenInfoErrors
- GetTokenInfoResponse
- GetTokenInfoResponses
- JobId
- JobResult
- JobResults
- LaunchNftCollectionAdvancedAdminParams
- LaunchNftCollectionData
- LaunchNftCollectionError
- LaunchNftCollectionErrors
- LaunchNftCollectionResponse
- LaunchNftCollectionResponses
- LaunchNftCollectionStandardAdminParams
- LaunchNftCollectionTransactionBaseParams
- LaunchTokenAdvancedAdminParams
- LaunchTokenBondingCurveAdminParams
- LaunchTokenData
- LaunchTokenError
- LaunchTokenErrors
- LaunchTokenResponse
- LaunchTokenResponses
- LaunchTokenStandardAdminParams
- LaunchTokenTransactionBaseParams
- MintNftData
- MintNftError
- MintNftErrors
- MintNftResponse
- MintNftResponses
- MintTokensData
- MintTokensError
- MintTokensErrors
- MintTokensResponse
- MintTokensResponses
- NftData
- NftInfo
- NftMetadata
- NftMintParams
- NftMintTransactionParams
- NftRequestAnswer
- NftRequestParams
- NftTransaction
- NftTransactionBaseParams
- NftTransactionParams
- NftTransactionType
- NftTransactions
- NftV2RequestAnswer
- NonceRequestParams
- NonceResponse
- Options
- ProofResult
- ProveData
- ProveError
- ProveErrors
- ProveNftTransaction
- ProveNftTransactions
- ProveResponse
- ProveResponses
- ProveTokenTransaction
- ProveTokenTransactions
- RedeemTokensData
- RedeemTokensError
- RedeemTokensErrors
- RedeemTokensResponse
- RedeemTokensResponses
- SellTokensData
- SellTokensError
- SellTokensErrors
- SellTokensResponse
- SellTokensResponses
- SendTransactionData
- SendTransactionError
- SendTransactionErrors
- SendTransactionParams
- SendTransactionReply
- SendTransactionResponse
- SendTransactionResponses
- TokenAirdropTransactionParams
- TokenBidData
- TokenBidError
- TokenBidErrors
- TokenBidResponse
- TokenBidResponses
- TokenBidTransactionParams
- TokenBurnTransactionParams
- TokenBuyTransactionParams
- TokenInfo
- TokenInfoRequestParams
- TokenMintTransactionParams
- TokenOfferData
- TokenOfferError
- TokenOfferErrors
- TokenOfferResponse
- TokenOfferResponses
- TokenOfferTransactionParams
- TokenRedeemTransactionParams
- TokenSellTransactionParams
- TokenState
- TokenSymbolAndAdmin
- TokenTransaction
- TokenTransactionBaseParams
- TokenTransactionParams
- TokenTransactionType
- TokenTransactions
- TokenTransferTransactionParams
- TokenUpdateAdminWhitelistTransactionParams
- TokenUpdateBidWhitelistTransactionParams
- TokenUpdateOfferWhitelistTransactionParams
- TokenWithdrawBidTransactionParams
- TokenWithdrawOfferTransactionParams
- TransactionPayloads
- TransactionStatus
- TransactionStatusParams
- TransferTokensData
- TransferTokensError
- TransferTokensErrors
- TransferTokensResponse
- TransferTokensResponses
- TxStatus
- TxStatusData
- TxStatusError
- TxStatusErrors
- TxStatusResponse
- TxStatusResponses
- UpdateTokenAdminWhitelistData
- UpdateTokenAdminWhitelistError
- UpdateTokenAdminWhitelistErrors
- UpdateTokenAdminWhitelistResponse
- UpdateTokenAdminWhitelistResponses
- UpdateTokenBidWhitelistData
- UpdateTokenBidWhitelistError
- UpdateTokenBidWhitelistErrors
- UpdateTokenBidWhitelistResponse
- UpdateTokenBidWhitelistResponses
- UpdateTokenOfferWhitelistData
- UpdateTokenOfferWhitelistError
- UpdateTokenOfferWhitelistErrors
- UpdateTokenOfferWhitelistResponse
- UpdateTokenOfferWhitelistResponses
- Whitelist
- WithdrawTokenBidData
- WithdrawTokenBidError
- WithdrawTokenBidErrors
- WithdrawTokenBidResponse
- WithdrawTokenBidResponses
- WithdrawTokenOfferData
- WithdrawTokenOfferError
- WithdrawTokenOfferErrors
- WithdrawTokenOfferResponse
- WithdrawTokenOfferResponses
Type Aliases
AdvancedNftCollectionAdminData
Type declaration
optionalallowChangeAdmin?: boolean
optionalallowChangeBaseUri?: boolean
Indicates whether the contract can change the base URI
optionalallowChangeCreator?: boolean
Indicates whether the contract can change the creator
optionalallowChangeName?: boolean
Indicates whether the contract can change the name
optionalallowChangeRoyalty?: boolean
Indicates whether the contract can change the royalty fee
optionalallowChangeTransferFee?: boolean
Indicates whether the contract can change the transfer fee
optionalcanPause?: boolean
Indicates whether the contract can be paused
optionalisPaused?: boolean
Indicates whether the contract is currently paused
AirdropTokensData
Type declaration
body: TokenAirdropTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/airdrop
AirdropTokensError
AirdropTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
AirdropTokensResponse
AirdropTokensResponses
Type declaration
200: AirdropTransactionResponse
Successfully built airdrop transaction.
AirdropTransactionResponse
Type declaration
optionaltxs?: TokenTransaction[]
List of token transactions created for the airdrop.
BalanceRequestParams
Type declaration
address: string
The Mina address for which to retrieve the balance.
optionaltokenAddress?: string
The address of the token contract (optional).
optionaltokenId?: string
The token ID (optional).
BalanceResponse
Type declaration
address: string
The Mina address for which the balance was requested.
optionalbalance?: number
The balance of the token for the specified address.
optionalhasAccount?: boolean
Indicates whether the account exists.
optionaltokenAddress?: string
The address of the token contract (optional).
optionaltokenId?: string
The token ID (optional).
BurnTokensData
Type declaration
body: TokenBurnTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/burn
BurnTokensError
BurnTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
BurnTokensResponse
BurnTokensResponses
Type declaration
200: TokenTransaction
Successfully built burn transaction.
BuyTokensData
Type declaration
body: TokenBuyTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/offer/buy
BuyTokensError
BuyTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
BuyTokensResponse
BuyTokensResponses
Type declaration
200: TokenTransaction
Successfully built buy transaction.
ClientOptions
Type declaration
baseUrl: https://minatokens.com/api/v1/ | https://devnet.minatokens.com/api/v1/ | https://zekotokens.com/api/v1/ | (string & {})
CollectionData
Type declaration
optionalisPaused?: boolean
Indicates whether the collection is currently paused
optionalmintingIsLimited?: boolean
If true, the minting is stopped and cannot be resumed
optionalrequireTransferApproval?: boolean
If true, transferring NFTs requires approval from the admin contract
optionalroyaltyFee?: number
The royalty fee percentage (e.g., 1000 = 1%, 100 = 0.1%, 10000 = 10%, 100000 = 100%)
optionaltransferFee?: number
The transfer fee amount
CollectionInfo
Type declaration
adminAddress: string
optionalbanner?: string
baseURL: string
chain: string
collectionAddress: string
collectionIsPaused: boolean
collectionName: string
contractType: collection
contractVerificationKeyHash: string
The verification key hash of the contract.
contractVersion: number
The version number of the contract.
created: number
creator: string
isPaused: boolean
optionallikes?: number
masterNFT: NftInfo
mintingIsLimited: boolean
rating: number
requireTransferApproval: boolean
royaltyFee: number
status: string
symbol: string
tokenId: string
transferFee: string
updated: number
uri: string
ContractInfo
Type declaration
[key string]: ContractProperty | (ContractProperty & { type?: name }) | (ContractProperty & { type?: address }) | (ContractProperty & { type?: tokenId }) | (ContractProperty & { type?: tokenId }) | (ContractProperty & { type?: symbol }) | (ContractProperty & { type?: uri }) | (ContractProperty & { type?: verificationKey }) | (ContractProperty & { type?: verificationKeyHash }) | (ContractProperty & { type?: zkappVersion })
address: ContractProperty & { type?: address }
derivedTokenId: ContractProperty & { type?: tokenId }
name: ContractProperty & { type?: name }
symbol: ContractProperty & { type?: symbol }
tokenId: ContractProperty & { type?: tokenId }
uri: ContractProperty & { type?: uri }
verificationKey: ContractProperty & { type?: verificationKey }
verificationKeyHash: ContractProperty & { type?: verificationKeyHash }
zkappVersion: ContractProperty & { type?: zkappVersion }
ContractInfoRequest
Type declaration
address: string
The contract address.
optionaltokenId?: string
Optional. The tokenId.
ContractProperty
Type declaration
optionalpresentation?: string
type: ContractPropertyType
value: string
ContractPropertyType
DeployedNftCollectionTransactionBaseParams
DeployedTokenTransactionBaseParams
ErrorResponse
Type declaration
optionalerror?: string
Error message detailing the issue.
FaucetData
Type declaration
body: FaucetParams
optionalpath?: never
optionalquery?: never
url: /faucet
FaucetError
FaucetErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
FaucetParams
Type declaration
address: string
The Mina address (public key) to receive the test tokens.
FaucetResponse
Type declaration
optionalerror?: string
Error message if the request failed.
optionalhash?: string
The transaction hash of the faucet transfer if successful.
optionalsuccess?: boolean
Indicates whether the faucet request was successful.
FaucetResponse2
FaucetResponses
Type declaration
200: FaucetResponse
Faucet response
GetContractInfoData
Type declaration
body: ContractInfoRequest
optionalpath?: never
optionalquery?: never
url: /info/contract
GetContractInfoError
GetContractInfoErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetContractInfoResponse
GetContractInfoResponses
Type declaration
200: ContractInfo[]
Successful retrieval of contract info for the given contract and his admin contract and other contracts that are related to it.
GetNftInfoData
Type declaration
body: NftRequestParams
optionalpath?: never
optionalquery?: never
url: /info/nft
GetNftInfoError
GetNftInfoErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetNftInfoResponse
GetNftInfoResponses
Type declaration
200: NftRequestAnswer
Successful response
GetNftV2InfoData
Type declaration
body: NftRequestParams
optionalpath?: never
optionalquery?: never
url: /info/nft-v2
GetNftV2InfoError
GetNftV2InfoErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetNftV2InfoResponse
GetNftV2InfoResponses
Type declaration
200: NftV2RequestAnswer
Successful response
GetNonceData
Type declaration
body: NonceRequestParams
optionalpath?: never
optionalquery?: never
url: /info/nonce
GetNonceError
GetNonceErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetNonceResponse
GetNonceResponses
Type declaration
200: NonceResponse
Successful retrieval of nonce.
GetProofData
Type declaration
body: JobId
optionalpath?: never
optionalquery?: never
url: /transaction/proof
GetProofError
GetProofErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetProofResponse
GetProofResponses
Type declaration
200: JobResults
Successfully retrieved job status and proofs.
GetTokenBalanceData
Type declaration
body: BalanceRequestParams
optionalpath?: never
optionalquery?: never
url: /info/balance
GetTokenBalanceError
GetTokenBalanceErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetTokenBalanceResponse
GetTokenBalanceResponses
Type declaration
200: BalanceResponse
Successful retrieval of balance.
GetTokenInfoData
Type declaration
body: TokenInfoRequestParams
optionalpath?: never
optionalquery?: never
url: /info/token
GetTokenInfoError
GetTokenInfoErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
GetTokenInfoResponse
GetTokenInfoResponses
Type declaration
200: TokenState
Successful retrieval of token information.
JobId
Type declaration
jobId: string
The job ID returned by the
/prove
endpoint.
JobResult
Type declaration
optionalerror?: string
Error message if proof generation failed for this transaction.
optionalhash?: string
The transaction hash if broadcasted.
optionalstatus?: string
The status of the transaction.
success: boolean
Indicates whether the proof generation for this transaction was successful.
optionaltx?: string
The transaction data.
JobResults
Type declaration
optionalerror?: string
Error message if the job failed.
optionaljobStatus?: created | started | finished | failed | used | restarted
The current status of the job.
optionalresults?: JobResult[]
Results for each transaction in the job.
optionalsuccess?: boolean
Indicates whether the job was successful.
LaunchNftCollectionAdvancedAdminParams
LaunchNftCollectionData
Type declaration
body: LaunchNftCollectionStandardAdminParams | LaunchNftCollectionAdvancedAdminParams
optionalpath?: never
optionalquery?: never
url: /nft/launch
LaunchNftCollectionError
LaunchNftCollectionErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
LaunchNftCollectionResponse
LaunchNftCollectionResponses
Type declaration
200: NftTransaction
Successful deployment of a new NFT Collection.
LaunchNftCollectionStandardAdminParams
LaunchNftCollectionTransactionBaseParams
LaunchTokenAdvancedAdminParams
LaunchTokenBondingCurveAdminParams
LaunchTokenData
Type declaration
body: LaunchTokenStandardAdminParams | LaunchTokenAdvancedAdminParams | LaunchTokenBondingCurveAdminParams
optionalpath?: never
optionalquery?: never
url: /token/launch
LaunchTokenError
LaunchTokenErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
LaunchTokenResponse
LaunchTokenResponses
Type declaration
200: TokenTransaction
Successful deployment of a new token.
LaunchTokenStandardAdminParams
LaunchTokenTransactionBaseParams
MintNftData
Type declaration
body: NftMintTransactionParams
optionalpath?: never
optionalquery?: never
url: /nft/mint
MintNftError
MintNftErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
MintNftResponse
MintNftResponses
Type declaration
200: NftTransaction
Successfully built mint transaction.
MintTokensData
Type declaration
body: TokenMintTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/mint
MintTokensError
MintTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
MintTokensResponse
MintTokensResponses
Type declaration
200: TokenTransaction
Successfully built mint transaction.
NftData
Type declaration
optionalapproved?: string
The public key of the approved address of the NFT
optionalcanApprove?: boolean
Specifies if the NFT's approved address can be changed (readonly)
optionalcanChangeMetadata?: boolean
Indicates whether the NFT's metadata can be updated (readonly)
optionalcanChangeMetadataVerificationKeyHash?: boolean
Indicates whether the verification key hash for the metadata can be changed (readonly)
optionalcanChangeName?: boolean
Specifies if the name of the NFT can be changed (readonly)
optionalcanChangeOwnerByProof?: boolean
Determines whether the NFT's ownership can be changed via a zero-knowledge proof (readonly)
optionalcanChangeStorage?: boolean
Determines whether the storage associated with the NFT can be altered (readonly)
optionalcanPause?: boolean
Specifies if the NFT contract can be paused, preventing certain operations (readonly)
optionalcanTransfer?: boolean
Specifies if the NFT's ownership can be transferred (readonly)
optionalid?: string
The unique identifier of the NFT within the collection. A bigint encoded as a string.
optionalisPaused?: boolean
Indicates whether the NFT contract is currently paused
owner: string
The public key of the owner of the NFT
optionalrequireOwnerAuthorizationToUpgrade?: boolean
Determines whether the owner's authorization is required to upgrade the NFT's verification key (readonly)
optionalversion?: number
The version number of the NFT state
NftInfo
Type declaration
optionalapproved?: string
canApprove: boolean
canChangeMetadata: boolean
canChangeMetadataVerificationKeyHash: boolean
canChangeName: boolean
canChangeOwnerByProof: boolean
canChangeStorage: boolean
canPause: boolean
canTransfer: boolean
chain: string
collectionAddress: string
optionalcollectionBaseURL?: string
The base URL of the collection.
collectionName: string
optionalcollectionSymbol?: string
The symbol of the collection.
optionalcollectionUri?: string
The URI of the collection.
contractType: nft
contractVerificationKeyHash: string
The verification key hash of the contract.
contractVersion: number
The version number of the contract.
created: number
optionaldescription?: string
id: string
image: string
isPaused: boolean
optionallikes?: number
metadata: {}
[key string]: unknown
metadataRoot: string
metadataVerificationKeyHash: string
name: string
owner: string
optionalprice?: number
rating: number
requireOwnerAuthorizationToUpgrade: boolean
status: string
storage: string
symbol: string
tokenAddress: string
tokenId: string
type: nft | collection
updated: number
uri: string
version: number
NftMetadata
Type declaration
optionalbanner?: string
Optional banner image URL or IPFS hash. Required for Collection Master NFT.
optionaldescription?: string
Optional description of the NFT
image: string
The image URL or IPFS hash associated with the NFT
name: string
The name of the NFT
optionaltraits?: { isPrivate?: boolean; key: string; type: string | text | image | url | field | number | address | map | tree; value: string | {} }[]
NftMintParams
Type declaration
optionaladdress?: string
The address of the NFT contract
optionaladdressPrivateKey?: string
The private key of the NFT contract
data: NftData
The data associated with the NFT, including owner, approved, version, id, permissions and flags
optionalexpiry?: number
The expiry time slot for minting the NFT
optionalfee?: number
The fee associated with minting the NFT
metadata: string | NftMetadata
The metadata associated with the NFT, Field as a string or NftMetadata object
optionalmetadataVerificationKeyHash?: string
The hash of the verification key used for metadata proofs, Field as a string
name: string
The name of the NFT
optionalstorage?: string
The off-chain storage information (e.g., IPFS hash)
optionaltokenId?: number
The token ID of the NFT
NftMintTransactionParams
NftRequestAnswer
Type declaration
collection: CollectionInfo
nft: NftInfo
NftRequestParams
Type declaration
collectionAddress: string
Always set to B62qs2NthDuxAT94tTFg6MtuaP1gaBxTZyNv9D3uQiQciy1VsaimNFT for Mina NFT V2.
optionalnftAddress?: string
The unique NFT address.
NftTransaction
NftTransactionBaseParams
Type declaration
optionalcollectionAddress?: string
Optional. The address of the NFT collection.
optionaldeveloperFee?: number
Optional. The developer fee for the transaction.
optionalmemo?: string
Optional. A memo for the transaction.
optionalnonce?: number
Optional. The nonce for the transaction.
sender: string
The address (public key) of the sender.
optionalsenderPrivateKey?: string
The private key of the sender. It is NOT recommended to use this field. Please use the
sender
field instead. Use this field at your own risk and only if you know what you are doing and do not have access to mina-signer or wallet to get the signature.optionaltxType?: NftTransactionType
Type of the NFT transaction.
NftTransactionParams
NftTransactionType
NftTransactions
Type declaration
txs: NftTransaction[]
Array of NFT transactions.
NftV2RequestAnswer
Type declaration
optionalalgolia?: {}
[key string]: unknown
optionalcontractAddress?: string
optionalcontractUri?: string
optionalmetadata?: {}
[key string]: unknown
optionalmetadataRoot?: { data?: string; kind?: string }
optionaldata?: string
optionalkind?: string
optionalname?: string
optionalnftAddress?: string
optionalowner?: string
optionalprice?: number
optionalstorage?: string
optionaltokenId?: string
optionaltokenSymbol?: string
optionalversion?: number
NonceRequestParams
Type declaration
address: string
The Mina address for which to retrieve the nonce.
NonceResponse
Type declaration
address: string
The Mina address for which the nonce was requested.
optionalhasAccount?: boolean
Indicates whether the account exists.
optionalnonce?: number
The nonce for the specified address.
Options
Type parameters
- TData: TDataShape = TDataShape
- ThrowOnError: boolean = boolean
ProofResult
Type declaration
optionalerror?: string
Error message if proof generation failed.
optionalhash?: string
The transaction hash if the proof was successfully applied.
optionalsuccess?: boolean
Indicates whether the proof generation was successful.
ProveData
Type declaration
body: ProveTokenTransaction | ProveTokenTransactions | ProveNftTransaction | ProveNftTransactions
optionalpath?: never
optionalquery?: never
url: /transaction/prove
ProveError
ProveErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
ProveNftTransaction
Type declaration
optionalsendTransaction?: boolean
Optional. Whether to broadcast the transaction after proving.
signedData: string
The signed data for the transaction.
tx: NftTransaction
The transaction object.
ProveNftTransactions
Type declaration
txs: ProveNftTransaction[]
Array of transactions to be proved.
ProveResponse
ProveResponses
Type declaration
200: JobId
Successfully initiated proof generation.
ProveTokenTransaction
Type declaration
optionalsendTransaction?: boolean
Optional. Whether to broadcast the transaction after proving.
signedData: string
The signed data for the transaction.
tx: TokenTransaction
The transaction object.
ProveTokenTransactions
Type declaration
txs: ProveTokenTransaction[]
Array of transactions to be proved.
RedeemTokensData
Type declaration
body: TokenRedeemTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/redeem
RedeemTokensError
RedeemTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
RedeemTokensResponse
RedeemTokensResponses
Type declaration
200: TokenTransaction
Successfully built redeem transaction.
SellTokensData
Type declaration
body: TokenSellTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/bid/sell
SellTokensError
SellTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
SellTokensResponse
SellTokensResponses
Type declaration
200: TokenTransaction
Successfully built sell transaction.
SendTransactionData
Type declaration
body: SendTransactionParams
optionalpath?: never
optionalquery?: never
url: /transaction/send
SendTransactionError
SendTransactionErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
SendTransactionParams
Type declaration
transaction: string
The transaction to send.
SendTransactionReply
Type declaration
optionalerror?: {}
Error details if the transaction failed.
[key string]: unknown
optionalhash?: string
The transaction hash if successful.
optionalstatus?: string
The status of the transaction.
success: boolean
Whether the transaction was sent to the network.
SendTransactionResponse
SendTransactionResponses
Type declaration
200: SendTransactionReply
Successfully sent transaction.
TokenAirdropTransactionParams
TokenBidData
Type declaration
body: TokenBidTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/bid/create
TokenBidError
TokenBidErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
TokenBidResponse
TokenBidResponses
Type declaration
200: TokenTransaction
Successfully built bid transaction.
TokenBidTransactionParams
TokenBurnTransactionParams
TokenBuyTransactionParams
TokenInfo
Type declaration
optionaladminContractsCode?: string[]
Optional. Code for the admin contracts.
optionaldescription?: string
Optional. Description of the token.
optionaldiscord?: string
Optional. Discord link associated with the token.
optionalfacebook?: string
Optional. Facebook page associated with the token.
optionalimageBase64?: string
Optional. Base64-encoded image data (max 1 MB).
optionalimageUrl?: string
Optional. URL of the token image.
optionalinstagram?: string
Optional. Instagram handle associated with the token.
optionalname?: string
Optional. The name of the token.
optionalsymbol?: string
The symbol of the token.
optionaltelegram?: string
Optional. Telegram link associated with the token.
optionaltokenContractCode?: string
Optional. Code for the token contract.
optionaltwitter?: string
Optional. Twitter handle associated with the token.
optionalwebsite?: string
Optional. Official website of the token.
TokenInfoRequestParams
Type declaration
tokenAddress: string
The address of the token contract.
TokenMintTransactionParams
TokenOfferData
Type declaration
body: TokenOfferTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/offer/create
TokenOfferError
TokenOfferErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
TokenOfferResponse
TokenOfferResponses
Type declaration
200: TokenTransaction
Successfully created offer transaction.
TokenOfferTransactionParams
TokenRedeemTransactionParams
TokenSellTransactionParams
TokenState
Type declaration
adminAddress: string
The address of the administrator.
adminContractAddress: string
The address of the admin contract.
adminTokenBalance: number
The token balance of the administrator.
adminTokenSymbol: string
The symbol of the admin token.
adminUri: string
The URI of the admin token metadata.
adminVerificationKeyHash: string
The verification key hash of the admin contract.
adminVersion: number
decimals: number
The number of decimal places the token uses.
isPaused: boolean
Indicates if the token contract is paused.
tokenAddress: string
The address of the token contract.
tokenId: string
The unique identifier of the token.
tokenSymbol: string
The symbol of the token.
totalSupply: number
The total supply of the token.
uri: string
The URI of the token metadata.
verificationKeyHash: string
The verification key hash of the token contract.
version: number
The version number of the token contract.
TokenSymbolAndAdmin
Type declaration
adminAddress: string
The address of the administrator.
adminContractAddress: string
The address of the admin contract.
tokenAddress: string
The address of the token contract.
tokenSymbol: string
The symbol of the token.
TokenTransaction
TokenTransactionBaseParams
Type declaration
optionaldeveloperFee?: number
Optional. The developer fee for the transaction.
optionalmemo?: string
Optional. A memo for the transaction.
optionalnonce?: number
Optional. The nonce for the transaction.
sender: string
The address (public key) of the sender.
optionalsenderPrivateKey?: string
The private key of the sender. It is NOT recommended to use this field. Please use the
sender
field instead. Use this field at your own risk and only if you know what you are doing and do not have access to mina-signer or wallet to get the signature.optionaltokenAddress?: string
Optional. The address of the token contract.
optionaltxType?: TokenTransactionType
Type of the token transaction.
TokenTransactionParams
TokenTransactionType
TokenTransactions
Type declaration
txs: TokenTransaction[]
Array of token transactions.
TokenTransferTransactionParams
TokenUpdateAdminWhitelistTransactionParams
TokenUpdateBidWhitelistTransactionParams
TokenUpdateOfferWhitelistTransactionParams
TokenWithdrawBidTransactionParams
TokenWithdrawOfferTransactionParams
TransactionPayloads
Type declaration
fee: number
The fee for the transaction.
memo: string
A memo for the transaction.
minaSignerPayload: { feePayer: { fee?: number; feePayer?: string; memo?: string; nonce?: number }; zkappCommand: {} }
feePayer: { fee?: number; feePayer?: string; memo?: string; nonce?: number }
optionalfee?: number
The fee for the transaction.
optionalfeePayer?: string
The fee payer's address.
optionalmemo?: string
A memo for the transaction.
optionalnonce?: number
The nonce for the transaction.
zkappCommand: {}
The zkApp command data.
[key string]: unknown
nonce: number
The nonce for the transaction.
proverPayload: string
The payload for the prover.
optionalsendTransaction?: boolean
Optional. Whether to broadcast the transaction after proving.
sender: string
The address initiating the transaction.
signedData: string
The signed data for the transaction.
transaction: string
The raw transaction data.
walletPayload: { feePayer?: { fee?: number; memo?: string }; nonce?: number; onlySign?: boolean; transaction?: string }
optionalfeePayer?: { fee?: number; memo?: string }
optionalfee?: number
The fee for the transaction.
optionalmemo?: string
A memo for the transaction.
optionalnonce?: number
The nonce for the transaction.
optionalonlySign?: boolean
Indicates if only signature is needed.
optionaltransaction?: string
The transaction data.
TransactionStatus
Type declaration
optionaldetails?: { blockHeight?: number; blockStatus?: string; stateHash?: string; timestamp?: number; txHash?: string; txStatus?: string }
The details of the transaction.
optionalblockHeight?: number
The height of the block containing the transaction.
optionalblockStatus?: string
The status of the block.
optionalstateHash?: string
The state hash of the block.
optionaltimestamp?: number
The timestamp of the block.
optionaltxHash?: string
The transaction hash.
optionaltxStatus?: string
The status of the transaction in the block.
optionalerror?: string
The transaction hash.
optionalhash?: string
The transaction hash.
optionalstatus?: pending | applied | failed | unknown
The status of the transaction.
TransactionStatusParams
Type declaration
hash: string
The transaction hash to check the status of.
TransferTokensData
Type declaration
body: TokenTransferTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/transfer
TransferTokensError
TransferTokensErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
TransferTokensResponse
TransferTokensResponses
Type declaration
200: TokenTransaction
Successfully built transfer transaction.
TxStatus
Type declaration
optionalblockHeight?: number
The height of the block containing the transaction.
optionalblockStatus?: string
The status of the block.
optionalstateHash?: string
The state hash of the block.
optionaltimestamp?: number
The timestamp of the block.
optionaltxHash?: string
The transaction hash.
optionaltxStatus?: string
The status of the transaction in the block.
TxStatusData
Type declaration
body: TransactionStatusParams
optionalpath?: never
optionalquery?: never
url: /transaction/status
TxStatusError
TxStatusErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
TxStatusResponse
TxStatusResponses
Type declaration
200: TransactionStatus
Successfully retrieved transaction status.
UpdateTokenAdminWhitelistData
Type declaration
body: TokenUpdateAdminWhitelistTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/admin/whitelist
UpdateTokenAdminWhitelistError
UpdateTokenAdminWhitelistErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
UpdateTokenAdminWhitelistResponse
UpdateTokenAdminWhitelistResponses
Type declaration
200: TokenTransaction
Successfully built update admin whitelist transaction.
UpdateTokenBidWhitelistData
Type declaration
body: TokenUpdateBidWhitelistTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/bid/whitelist
UpdateTokenBidWhitelistError
UpdateTokenBidWhitelistErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
UpdateTokenBidWhitelistResponse
UpdateTokenBidWhitelistResponses
Type declaration
200: TokenTransaction
Successfully built update bid whitelist transaction.
UpdateTokenOfferWhitelistData
Type declaration
body: TokenUpdateOfferWhitelistTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/offer/whitelist
UpdateTokenOfferWhitelistError
UpdateTokenOfferWhitelistErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
UpdateTokenOfferWhitelistResponse
UpdateTokenOfferWhitelistResponses
Type declaration
200: TokenTransaction
Successfully built update offer whitelist transaction.
Whitelist
Optional. List of whitelisted addresses with optional amounts, or a string.
WithdrawTokenBidData
Type declaration
body: TokenWithdrawBidTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/bid/withdraw
WithdrawTokenBidError
WithdrawTokenBidErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
WithdrawTokenBidResponse
WithdrawTokenBidResponses
Type declaration
200: TokenTransaction
Successfully built withdraw bid transaction.
WithdrawTokenOfferData
Type declaration
body: TokenWithdrawOfferTransactionParams
optionalpath?: never
optionalquery?: never
url: /token/offer/withdraw
WithdrawTokenOfferError
WithdrawTokenOfferErrors
Type declaration
400: ErrorResponse
Bad request - invalid input parameters.
401: ErrorResponse
Unauthorized - user not authenticated.
403: ErrorResponse
Forbidden - user doesn't have permission.
429: ErrorResponse
Too many requests.
500: ErrorResponse
Internal server error - something went wrong during the request.
503: ErrorResponse
Service unavailable - blockchain or other external service is down.
WithdrawTokenOfferResponse
WithdrawTokenOfferResponses
Type declaration
200: TokenTransaction
Successfully built withdraw offer transaction.
Indicates whether the contract can change the admin