Bot Commands

Servers with Friend of Catto status automatically enjoys all the premium features (and maybe more) without further action.

/kl-init

Creates a new integration within Discord server. An integration represents a NFT collection which Discord server members can verify their holder status.

For Discord server admin with MANAGE_SERVER permission.

1 integration per Discord server. If you need more integrations in a single Discord server, consider supporting us and go premium by minting/purchasing a Catto Katsu NFT on Fantom (Ethereum/Harmony One coming soon).

Parameters:

  • collection-title : A human readable collection title. When missing, contract address will be displayed instead

  • blockchain : The blockchain where the NFT collection exists

  • contract : The contract address of the NFT collection

  • role : The role to grant upon successful token holder verification

  • min-tokens : The minimum amount of tokens that must be in holder's wallet in order to verify successfully to gain role

Premium:

Able to create more than 1 integrations, up to a max of 5 integrations per Discord server. If you need more, drop us a message in our Discord, or any other social channels!

/kl-enable-audit

Note on Staking

As of now, if a user participates in staking of any kind that requires a transfer of token from user wallet to the staking contract, user's role will be revoked.

We are exploring solutions around this.

Enables audit for an integration. By default, audit feature is not enabled. By enabling this feature, if a token holder does not holds the required token anymore (removed from holder wallet), the bot will automatically remove holder's Discord role.

For Discord server admin with MANAGE_SERVER permission.

Parameters:

  • integration-id : The ID of the integration to enable for. Use /kl-list-integrations to find out the ID

/kl-disable-audit

Disables audit for an integration.

For Discord server admin with MANAGE_SERVER permission.

Parameters:

  • integration-id : The ID of the integration to disable for. Use /kl-list-integrations to find out the ID

/kl-verify

Begins the token holder verification process.

Parameters:

  • wallet-address : The wallet address used to hold the NFT, and to be used for the verification

/kl-list-integrations

Returns a list of available integrations in the Discord server.

Can be used for everyone, but for Discord server admin with MANAGE_SERVER role, you can view the integration ID along with the collection name.

/kl-get-integration

Returns an integration's details in the Discord server.

For Discord server admin with MANAGE_SERVER permission.

Parameters:

  • integration-id : The ID of the integration

/kl-find-manually-verified

Finds any user who has a holder role not obtained via Katsu.Land.

Eg.

  • If a user is given the holder role manually

  • If a user obtained the holder role via other tools/bots, eg. Collab.Land

Please contact the users from the command response to verify using /kl-verify command if you want Katsu.Land to track their token ownership status.

This is a high latency (takes very long) command, and could fail if your server has more than a thousand users. You can retry the command, and if it still does not work, please contact us.

Coming soon: Katsu.Land Discord Admin Management Portal to resolve this issue

For Discord server admin with MANAGE_SERVER permission.

Parameters:

  • integration-id : The ID of the integration to find for. Use /kl-list-integrations to find out the ID

/kl-remove-integration

Removes the specified integration.

For Discord server admin with MANAGE_SERVER permission.

Parameters:

  • integration-id : The ID of the integration to be removed. Use /kl-list-integrations to find out the ID

  • cleanup-role (premium) : Specify whether to remove the role from members who have verified using this integration. Defaults to false

Premium:

If set to true, command will remove the role from the users who got it via the integration to be removed. Users who got the role via other means (eg. manually granted by server admin) will not be affected.

No effect if server has no premium status.

/kl-activate-premium

Activates premium status for an integration.

For Discord server admin with MANAGE_SERVER permission.

Parameters:

  • wallet-address : The wallet address that holds the Catto

  • blockchain: The chain your Catto is on

  • token-id : The Catto token ID you want to use for activating premium status for this integration. Each Catto can only be attached to one integration at a time

/kl-deactivate-premium

Deactivates premium status for an integration.

For Discord server admin with MANAGE_SERVER permission.

Last updated