Skip to content

MsgDeleteIncomingApproval

MsgDeleteIncomingApproval deletes one incoming approval by ID without rebuilding the full approval list.

Deletes a single incoming approval for the signer in one collection. It is a wrapper around MsgUpdateUserApprovals.

Example

bash
bb tx tokenization delete-incoming-approval 1 accept-from-alice --from bob --chain-id bitbadges-1
ts
import { BitBadgesSigningClient, GenericCosmosAdapter, MsgDeleteIncomingApproval } from 'bitbadges';

const adapter = await GenericCosmosAdapter.fromMnemonic(process.env.MNEMONIC!, 'bitbadges-1');
const client = new BitBadgesSigningClient({ adapter, network: 'mainnet' });

const msg = new MsgDeleteIncomingApproval({
  creator: 'bb1py4mfpg6uf59qkyzg0nmau322c5873eeysp5ue',
  collectionId: 1n,
  approvalId: 'accept-from-alice'
});

const result = await client.signAndBroadcast([msg]);
console.log(result.txHash, result.success);
json
{
  "creator": "bb1py4mfpg6uf59qkyzg0nmau322c5873eeysp5ue",
  "collectionId": "1",
  "approvalId": "accept-from-alice"
}

Fields

FieldTypeRequiredDescription
creatorstringyesSigner. Users can only delete their own approvals.
collectionIdUintyesCollection. "0" resolves to the most recently created collection.
approvalIdstringyesID of the incoming approval to delete.

Response

FieldTypeDescription
foundboolWhether the approval existed. Always true on success; a missing ID is an error.
versionstringVersion of the deleted approval.
reviewItemsstring[]Advisory notes.

Behavior

  • Loads the signer's current incoming approvals (or the collection defaults) and removes the entry with approvalId.
  • Fails with ErrApprovalNotFound if no incoming approval has that ID.
  • Runs the full MsgUpdateUserApprovals path with updateIncomingApprovals: true, so canUpdateIncomingApprovals and the archived check apply.

Edit this page on GitHub