/v2/app/coin/unlock
This locked
parameter specifies whether the minted coins can be traded by a user. If minted coins are locked
by the developer, the users balance will reflect the newly minted coins however user may not transfer those coins out of their wallet until they are unlocked by the developer.
Upon calling this API, a transaction is raised and submitted to the Queue on blockchain. MetaKeep, behind the scenes, employs several strategies to make sure transactions succeed, and at the lowest cost.
You can get the status of this blockchain transaction by querying for transaction status by copying transactionId
from this API response and querying it in Transaction Status API.
Replaying this API
Once you get a
status
response asQUEUED
, replaying this API doesn't give you the latest status; Replaying the same API with the sameIdempotency-Key
results in the same response, always with status-QUEUED
. You must query the Transaction Status API for the latest status.
As you would learn from the Transaction Status API docs, if a transaction failed, MetaKeep would have exhausted all feasible smart AI based strategies to recover from failure, that would have been attempted by humans and that the "FAILED" status, if shown, is final.
Api Error Status
You can find error status returned by the api here.
© Copyright 2024, Passbird Research Inc.