MsgSetOutgoingApproval

A helper message to set a single outgoing approval for badge transfers. This is a developer-friendly wrapper around MsgUpdateUserApprovals that simplifies setting individual outgoing approvals. For more information, we refer to the MsgUpdateUserApprovals documentation.

Overview

This message allows you to set or update a single outgoing approval without having to construct the full MsgUpdateUserApprovals message. It automatically handles version management and validation.

Proto Definition

message MsgSetOutgoingApproval {
  string creator = 1; // User setting the approval
  string collectionId = 2; // Target collection for approval
  UserOutgoingApproval approval = 3; // The outgoing approval to set
}

message MsgSetOutgoingApprovalResponse {}

Usage Example

# CLI command
bitbadgeschaind tx badges set-outgoing-approval [collection-id] '[approval-json]' --from user-key

Behavior

  • New Approval: If the approval ID doesn't exist, a new approval is created with version 0

  • Update Existing: If the approval ID already exists, the approval is updated and the version is incremented

  • No Change: If the approval content hasn't changed, the version remains the same

  • Validation: The approval is validated according to the collection's permissions and user's approval update permissions

Authorization & Permissions

Users can only set their own outgoing approvals. The operation must be performed according to the permissions set (i.e. the userPermissions previously set for that user).

Related Messages

PreviousMsgSetManagerNextMsgSetStandards

Last updated