Activate Wallet

Edit online

Activates a wallet by deploying its account contract on-chain. Activation is required only for networks where accounts must be explicitly deployed before they can initiate transactions.

Some examples:

Starknet: Deploys the account contract using the wallet’s public key. No parameters are required in the request body.
Concordium: Deploys the account using credential deployment information and cryptographic randomness returned by the IDApp.

Wallets on most other networks do not require explicit activation.

HTTP request

PUT /wallets/{walletId}/activate

Authorization requirements

Header	Type	Required	Description
`Authorization`	string	Yes	Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.
`X-DFNS-USERACTION`	string	Yes	User action signature used to authorize change-inducing requests. See User Action Signing flows for instructions on generating this signature.

Path parameter

Parameter	Type	Required	Description
`walletId`	string	Yes	The wallet ID to activate. Length: 1 to 64 characters.

Request body

StarknetNo request parameters required.

curl --request POST \
  --url https://api.digitalassets.ibm.com/wallets/{walletId}/activate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '{}'

ConcordiumProvide the account deployment transaction according to the Concordium SDK specification.

Response

200: Success

Returns the activation transaction.

Example response:

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "externalId": "<string>"
}