定期委任

定期委任により、ユーザーは別のウォレットまたはサービスに対して、期間ごとにリセットされる上限額までの引き出しを承認できます。

このガイドでは、各構成要素を明確に示します。まずアカウントを導出し、必要に応じてSubscription Authorityを初期化し、定期委任を作成してから、その委任PDAを転送に使用します。

インストール

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

委任の作成

セットアップは4つの部分で構成されています:

ユーザー署名者とサブスクリプションプラグインを使用してクライアントを作成します。
ユーザーのトークンアカウント、Subscription Authority PDA、定期委任PDAを導出します。
Subscription Authorityがまだ存在しない場合は初期化します。
期間ごとの金額、期間の長さ、開始時刻、有効期限を指定して定期委任を作成します。

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();

委任からの転送

各転送は委任先が署名します。プログラムは現在の期間を確認し、その期間の残り許容額を超える転送を拒否します。

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();

デリゲーションの取り消し

デリゲーターはいつでも定期的なデリゲーションを取り消すことができます。取り消すとデリゲーションPDAが閉鎖され、そのrentが署名者に返還されます。

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

注意事項

amountPerPeriodは基本単位で表されます。小数点以下6桁のトークンの場合、1_000_000は1トークンを意味します。
プログラムは現在の期間の残り許容量を超える転送を拒否します。
次の期間が始まると、引き出し額がリセットされます。
ユーザーはセットアップおよび取り消しトランザクションに署名します。デリゲート先は転送に署名します。

インストール

委任の作成

委任からの転送

デリゲーションの取り消し

注意事項

目次