# Memo integration guide · Chromia Docs (concept)

> The memo feature adds an optional memo requirement for FT4 transfers, ensuring that certain accounts mandate memos for all incoming transfers.

Source: https://docs.chromia.com/build/integrations/memo-guide/

# Memo integration guide

On this page

* [Business value](#business-value)
* [Enhanced transaction tracking](#enhanced-transaction-tracking)
* [Operational efficiency](#operational-efficiency)
* [Risk mitigation](#risk-mitigation)
* [Key components](#key-components)
* [Operations](#operations)
* [Queries](#queries)
* [Example workflows](#example-workflows)
* [FT4 client-side integration](#ft4-client-side-integration)
* [Rell test scripts](#rell-test-scripts)
* [Use cases](#use-cases)
* [Next steps](#next-steps)

The memo feature adds an optional memo requirement for FT4 transfers, ensuring that certain accounts mandate memos for
all incoming transfers. This feature is useful for attaching textual annotations to blockchain transactions, making it
especially beneficial for applications requiring transaction context and shared account management.

## Business value

The memo system delivers significant business benefits:

### Enhanced transaction tracking

* **Contextual information** attached to transfers for better identification
* **Optional memo enforcement** allows flexible account configuration
* **Textual annotations** provide human-readable transaction context
* **Standardized protocols** ensure consistent memo handling across platforms

### Operational efficiency

* **Simplified account management** for shared accounts and complex workflows
* **Reduced operational overhead** in transaction identification and reconciliation
* **Flexible account configuration** supports different business requirements
* **Automated processing** reduces manual intervention in transaction tracking

### Risk mitigation

* **Transaction context** prevents misallocation of funds in shared accounts
* **Memo requirements** ensure proper identification of transfer purposes
* **Audit trail enhancement** provides better transaction history and compliance
* **Error reduction** through clear transaction labeling and identification

## Key components

### Operations

1. **Enable memo requirement**
   * Operation: `enable_transfer_memo()`
   * Description: Activates memo enforcement for an FT4 account, requiring that all incoming transfers include a memo.
2. **Disable memo requirement**
   * Operation: `disable_transfer_memo()`
   * Description: Deactivates memo enforcement, allowing incoming transfers without a memo.
3. **Add a memo**
   * Operation: `memo(text)`
   * Description: Attaches a textual memo to a transfer.
   * Constraints:
     + The memo text must be between 1 and 50 characters.
     + This operation is only valid when paired with an `ft4.transfer` operation targeting accounts that require memos.

### **Queries**

Check memo requirement

* Query: `does_account_require_memo(account_id: byte_array): boolean`
* Description: Checks if an FT4 account enforces memo requirements for incoming transfers.

tip

For the full implementation of the memo feature, refer to the source code
[here](https://gitlab.com/chromaway/core/directory-chain/-/blob/1.73.8/src/economy_chain/economy_chain_transfer.rell).

## Example workflows

### FT4 client-side integration

**Receiver** account should allow to add `memo` to transactions:

JavaScript

```
/... code for initialization
await session.call(op("enable_transfer_memo"));
```

**Sender** account of transfer transactions can add `memo` if it was enabled by receiver:

JavaScript

```
// Initialization code
const tb = session.transactionBuilder();
    tb.add({name: "memo", args: [memo]}, { authenticator: noopAuthenticator })
      .add(transfer(<ACCOUNT_ID>, <assetId>, <amount>))
      .buildAndSend();
```

Find complete instructions for FT4 client-side initialization and asset transfers [here](https://docs.chromia.com/build/ft4/client/client-setup/).

note

You can find more examples of memo usage in the
[Recipes repository](https://bitbucket.org/chromawallet/recipes/src/main/memo).

### Rell test scripts

#### Enable memo requirement

Rell

```
rell.test.tx()
    .op(enable_transfer_memo())
    .op(test.ft_auth_operation_for(alice.keypair.pub))
    .sign(alice.keypair)
    .run();
```

#### Transfer with memo

Rell

```
rell.test.tx()
    .op(memo("For invoice #1234"))
    .op(test.ft_auth_operation_for(alice.keypair.pub))
    .op(assets.external.transfer(bob.account_id, asset.id, 100))
    .sign(alice.keypair)
    .run();
```

#### Query memo requirement

Rell

```
val requires_memo = does_account_require_memo(bob.account_id);
print("Bob's account requires memo: %s".format(requires_memo));
```

#### Invalid transfer (no memo)

Rell

```
rell.test.tx()
    .op(test.ft_auth_operation_for(alice.keypair.pub))
    .op(assets.external.transfer(bob.account_id, asset.id, 100))
    .sign(alice.keypair)
    .run_must_fail("Transfers to account ... require a memo");
```

tip

For the complete set of Rell test examples, check
[here](https://gitlab.com/chromaway/core/directory-chain/-/blob/1.73.8/src/economy_chain/test/economy_chain_transfer_test.rell).

## Use cases

The memo feature is particularly valuable for:

* **Exchange integrations** requiring transaction context for shared accounts
* **Shared account management** where multiple users access the same account
* **Payment processing** systems needing invoice or order references
* **Audit and compliance** requirements for transaction tracking
* **Cross-border transfers** requiring additional context information

## Next steps

* Explore the [FT4 client documentation](https://docs.chromia.com/build/ft4/client/client-setup/)
* Follow the [deployment guide](https://docs.chromia.com/get-started/create-dapp/deploy-to-testnet/)
* Check out [other integration guides](https://docs.chromia.com/build/integrations/) on Chromia

[View this page on docs.chromia.com](https://docs.chromia.com/build/integrations/memo-guide/)Content mirrored from the live docs
