How to enable / disable automatic creation of transfer channels

Intro

This page describes how to enable and disable automatic creation of Transfer Channels.

A Transfer Channel can be created in two ways:

1. By calling establish_transfer_channel

This function lets a TA (see: Keyless addresses) create a Transfer Channel for transferring assets between their account and another one. However, setting up a channel costs the AppAgent one action point (Understanding action points and clearing points). Also, this function can only be called by a TA which also means this function can only be called within Clearing Transactions.

1. Automatically created during first transfer channel call

Instead of explicitly creating a Transfer Channel by calling establish_transfer_channel, the runtime can automatically create a Transfer Channel during player deposit processing.

The runtime will not always create a Transfer Channel since the automatic creation of a Transfer Channel is subject to three conditions:

1. The AppAgent allows automatic channel creation

2. The deposit amount is valid

3. Asset or NFT transfers are allowed (based on certain criteria)

Prerequisites

Before you proceed, ensure you satisfy the following prerequisites:

1. Create an owner address (see: How to set up owner / admin addresses on TRAIT)

2. Ensure you have enough TRAIT tokens (see: How to obtain TRAIT tokens)

3. Ensure you have already created an AppAgent (see: How to create AppAgent)

4. Ensure the AppAgent already has an admin added (see: How to add & delete AppAgent Admin)

How to enable automatic creation of transfer channels

⚠️ By default, automatic Transfer Channel creation is disabled. If you wish to enable automatic creation of Transfer channels, make sure to do so only in conjunction with Transfer filters, otherwise malicious actors can drain your action points balance.

How to disable automatic creation of transfer channels