Ủy Quyền Định Kỳ

Ủy quyền định kỳ cho phép người dùng phê duyệt cho ví hoặc dịch vụ khác rút tiền trong giới hạn được đặt lại sau mỗi chu kỳ.

Hướng dẫn này giữ các thành phần chuyển động trong tầm nhìn. Bạn sẽ tạo các tài khoản trước, khởi tạo Subscription Authority nếu cần, tạo ủy quyền định kỳ, sau đó sử dụng PDA ủy quyền đó cho các giao dịch chuyển tiền.

Cài Đặt

pnpm add @solana/subscriptions @solana/kit @solana/kit-plugin-rpc @solana/kit-plugin-signer @solana-program/token

Tạo Ủy Quyền

Quá trình thiết lập gồm bốn phần:

Tạo client với người ký người dùng và plugin subscriptions.
Tạo token account của người dùng, PDA Subscription Authority và PDA ủy quyền định kỳ.
Khởi tạo Subscription Authority nếu chưa tồn tại.
Tạo ủy quyền định kỳ với số tiền chu kỳ, độ dài chu kỳ, thời gian bắt đầu và thời gian hết hạn.

import { address, createClient } from '@solana/kit';
import { solanaLocalRpc } from '@solana/kit-plugin-rpc';
import { signer } from '@solana/kit-plugin-signer';
import { findAssociatedTokenPda, TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
import {
  fetchMaybeSubscriptionAuthority,
  findRecurringDelegationPda,
  findSubscriptionAuthorityPda,
  subscriptionsProgram,
} from '@solana/subscriptions';

const client = createClient()
  .use(signer(userSigner))
  .use(solanaLocalRpc({ rpcUrl: 'http://127.0.0.1:8899' }))
  .use(subscriptionsProgram());

const tokenMint = address('TOKEN_MINT_ADDRESS_HERE');
const delegatee = address('DELEGATEE_WALLET_ADDRESS_HERE');
const now = BigInt(Math.floor(Date.now() / 1000));
const nonce = 0n;
const amountPerPeriod = 1_000_000n;
const periodLengthS = 86_400n;
const startTs = now;
const expiryTs = now + periodLengthS * 30n;

const [userAta] = await findAssociatedTokenPda({
  mint: tokenMint,
  owner: userSigner.address,
  tokenProgram: TOKEN_PROGRAM_ADDRESS,
});

const [subscriptionAuthorityPda] = await findSubscriptionAuthorityPda({
  user: userSigner.address,
  tokenMint,
});

const [delegationPda] = await findRecurringDelegationPda({
  subscriptionAuthority: subscriptionAuthorityPda,
  delegator: userSigner.address,
  delegatee,
  nonce,
});

const subscriptionAuthority = await fetchMaybeSubscriptionAuthority(
  client.rpc,
  subscriptionAuthorityPda,
);

if (!subscriptionAuthority.exists) {
  await client.subscriptions.instructions
    .initSubscriptionAuthority({
      tokenMint,
      tokenProgram: TOKEN_PROGRAM_ADDRESS,
      userAta,
    })
    .sendTransaction();
}

await client.subscriptions.instructions
  .createRecurringDelegation({
    tokenMint,
    delegatee,
    nonce,
    amountPerPeriod,
    periodLengthS,
    startTs,
    expiryTs,
  })
  .sendTransaction();

Chuyển Tiền Từ Ủy Quyền

Người được ủy quyền ký mỗi giao dịch chuyển tiền. Chương trình kiểm tra chu kỳ hiện tại và từ chối các giao dịch chuyển tiền vượt quá hạn mức còn lại của chu kỳ.

const receiverAta = address('RECEIVER_TOKEN_ACCOUNT_ADDRESS_HERE');

await client.subscriptions.instructions
  .transferRecurring({
    delegatee: delegateeSigner,
    delegator: userSigner.address,
    delegatorAta: userAta,
    tokenMint,
    delegationPda,
    amount: 100_000n,
    receiverAta,
    tokenProgram: TOKEN_PROGRAM_ADDRESS,
  })
  .sendTransaction();

Thu hồi ủy quyền

Người ủy quyền có thể thu hồi ủy quyền định kỳ bất cứ lúc nào. Việc thu hồi sẽ đóng PDA ủy quyền và hoàn trả tiền thuê cho người ký.

await client.subscriptions.instructions
  .revokeDelegation({
    authority: userSigner,
    delegationAccount: delegationPda,
  })
  .sendTransaction();

Ghi chú

amountPerPeriod tính theo đơn vị cơ bản. Đối với token có 6 chữ số thập phân, 1_000_000 có nghĩa là 1 token.
Chương trình từ chối các giao dịch chuyển vượt quá hạn mức còn lại của kỳ hiện tại.
Khi kỳ tiếp theo bắt đầu, số lượng đã rút sẽ được đặt lại.
Người dùng ký các giao dịch thiết lập và thu hồi. Người được ủy quyền ký các giao dịch chuyển.