Delegated Transfer

Transfer tokens as an approved delegate. The delegate signs instead of the owner, spending within the approved allowance.

transferDelegatedInterface transfers tokens from an associated token account as an approved delegate. The delegate is the transaction authority. Only the delegate and fee payer sign; the owner’s signature is not required.

• The recipient is a wallet address (associated token account derived and created internally)
• The amount must be within the approved allowance
• Each transfer reduces the remaining allowance

Agent skill

Install the agent skill:

npx skills add https://zkcompression.com

See the AI tools guide for dedicated skills.

Guide

1. Delegated Transfer

   Installation

   npm

   Install packages in your working directory:

   npm install @lightprotocol/stateless.js@beta \
               @lightprotocol/compressed-token@beta
   

   Install the CLI globally:

   npm install -g @lightprotocol/zk-compression-cli@beta
   

   yarn

   Install packages in your working directory:

   yarn add @lightprotocol/stateless.js@beta \
            @lightprotocol/compressed-token@beta
   

   Install the CLI globally:

   yarn global add @lightprotocol/zk-compression-cli@beta
   

   pnpm

   Install packages in your working directory:

   pnpm add @lightprotocol/stateless.js@beta \
            @lightprotocol/compressed-token@beta
   

   Install the CLI globally:

   pnpm add -g @lightprotocol/zk-compression-cli@beta
   

   Localnet

   # start local test-validator in a separate terminal
   light test-validator
   

   In the code examples, use createRpc() without arguments for localnet.

   Devnet

   Get an API key from Helius and add to .env:

   .env

   API_KEY=<your-helius-api-key>
   

   In the code examples, use createRpc(RPC_URL) with the devnet URL.

   Action

   import { Keypair } from "@solana/web3.js";
   import { transferDelegatedInterface } from "@lightprotocol/compressed-token/unified";
   import { rpc, payer, setup } from "../setup.js";
   
   (async function () {
       const { mint, senderAta } = await setup();
   
       // Approve a delegate first (see delegate-approve.mdx)
       const delegate = Keypair.generate();
       const recipient = Keypair.generate();
   
       // Delegate transfers tokens on behalf of the owner
       const tx = await transferDelegatedInterface(
           rpc,
           payer,
           senderAta,
           mint,
           recipient.publicKey,
           delegate,
           payer.publicKey,
           200_000
       );
   
       console.log("Delegated transfer:", tx);
   })();
   

   Instruction

   import {
       Keypair,
       Transaction,
       sendAndConfirmTransaction,
   } from "@solana/web3.js";
   import { createTransferDelegatedInterfaceInstructions } from "@lightprotocol/compressed-token/unified";
   import { rpc, payer, setup } from "../setup.js";
   
   (async function () {
       const { mint } = await setup();
   
       const delegate = Keypair.generate();
       const recipient = Keypair.generate();
   
       // Returns TransactionInstruction[][]. Each inner array is one txn.
       const instructions = await createTransferDelegatedInterfaceInstructions(
           rpc,
           payer.publicKey,
           mint,
           200_000,
           delegate.publicKey,
           payer.publicKey,
           recipient.publicKey,
           9
       );
   
       for (const ixs of instructions) {
           const tx = new Transaction().add(...ixs);
           const sig = await sendAndConfirmTransaction(rpc, tx, [payer, delegate]);
           console.log("Tx:", sig);
       }
   })();
   

Related Guides

Approve and revoke

Payments overview

---

Didn’t find what you were looking for?

Reach out! Telegram | email | Discord