Clawback assets

Authorized by: Asset Clawback Address

Revoking an asset for an account removes a specific number of the asset from the revoke target account. Revoking an asset from an account requires specifying an asset sender (the revoke target account) and an asset receiver (the account to transfer the funds back to). The code below illustrates the clawback transaction.

1
    """
2
    An asset clawback transaction is an asset transfer transaction with the
3
    `clawback_target` set to the account that is being clawed back from.
4

5
    Parameters for an asset transfer transaction.
6
    - sender: The address of the account that will send the transaction
7
    - asset_id: ID of the asset
8
    - amount: Amount of the asset to transfer (smallest divisible unit)
9
    - receiver: The account to send the asset to
10
    - clawback_target: The account to take the asset from, defaults to None
11
    """
12

13
    txn_result = algorand_client.send.asset_transfer(
14
        AssetTransferParams(
15
            sender=manager.address,
16
            asset_id=1234,
17
            amount=1,
18
            receiver=manager.address,
19
            clawback_target=account_to_be_clawbacked.address,  # account that is being clawed back from
20
        )
21
    )

const clawbackTxn = algosdk.makeAssetTransferTxnWithSuggestedParamsFromObject(
  {
    from: manager.addr,
    to: creator.addr,
    // revocationTarget is the account that is being clawed back from
    revocationTarget: receiver.addr,
    suggestedParams,
    assetIndex,
    amount: 1,
  }
);

const signedClawbackTxn = clawbackTxn.signTxn(manager.privateKey);
await algodClient.sendRawTransaction(signedClawbackTxn).do();
await algosdk.waitForConfirmation(
  algodClient,
  clawbackTxn.txID().toString(),
  3
);

goal asset send -a <amount-to-revoke> --asset <asset-name> -f <address-of-revoke-target> -t <address-to-send-assets-to> --clawback <clawback-address> --creator <creator-address> -d data

See also

Anatomy of an Asset Clawback Transaction