@zebec-network/solana-payroll-sdk 2.7.0 → 2.8.0

package/dist/services.d.ts

@@ -3,7 +3,7 @@ import { type Commitment } from "@solana/web3.js";
 import { MultiTransactionPayload, TransactionPayload } from "@zebec-network/solana-common";
 import type { ZebecConfigs as ZebecConfigsIdl } from "@zebec-network/zebec_configs";
 import type { ZebecPayroll as ZebecPayrollIdl } from "@zebec-network/zebec_payroll";
-import type { CancelMultiplePayrollParams, CancelPayrollParams, CancelUnlockParams, CardPurchaseInfo, ChangePayrollReceiverParams, CompanyDepositInfo, CompanyNonceInfo, CompleteUnlockParams, CreateCardParams, CreateMultiplePayrollParams, CreatePayrollParams, DistributeRewardsParams, PauseResumeMultiplePayrollParams, PauseResumePayrollParams, PayrollConfigInfo, PayrollMetadataInfo, RequestUnlockParams, SetMultipleTopupDelegateParams, SetTopupDelegateParams, SwapAndCreateCardParams, TokenMetadata, TopupMultiplePayrollParams, TopupPayrollParams, UserPurchaseRecordInfo, WithdrawMultiplePayrollParams, WithdrawPayrollParams, WithdrawRewardsParams, YieldDepositParams } from "./types.js";
+import type { CancelMultiplePayrollParams, CancelPayrollParams, CancelUnlockParams, CardPurchaseInfo, ChangePayrollReceiverParams, CompanyDepositInfo, CompanyNonceInfo, CompleteUnlockParams, CreateCardParams, CreateMultiplePayrollParams, CreatePayrollParams, DistributeRewardsParams, InstantDisbursementParams, PauseResumeMultiplePayrollParams, PauseResumePayrollParams, PayrollConfigInfo, PayrollMetadataInfo, RequestUnlockParams, SetMultipleTopupDelegateParams, SetTopupDelegateParams, SwapAndCreateCardParams, TokenMetadata, TopupMultiplePayrollParams, TopupPayrollParams, UserPurchaseRecordInfo, WithdrawMultiplePayrollParams, WithdrawPayrollParams, WithdrawRewardsParams, YieldDepositParams } from "./types.js";
 export declare function getPayrollConfig(configProgram: Program<ZebecConfigsIdl>, configName: string): Promise<PayrollConfigInfo>;
 export declare function getWhitelistedTokens(configProgram: Program<ZebecConfigsIdl>, configName: string, commitment?: "processed" | "confirmed" | "finalized"): Promise<TokenMetadata[]>;
 export declare function getPayrollMetadataInfo(program: Program<ZebecPayrollIdl>, payrollMetadata: Address, commitment?: Commitment): Promise<PayrollMetadataInfo>;
@@ -37,3 +37,4 @@ export declare function getCardIndexInfo(payrollProgram: Program<ZebecPayrollIdl
 export declare function getNextCardIndex(payrollProgram: Program<ZebecPayrollIdl>, entCardConfigName: string, commitment?: Commitment): Promise<bigint>;
 export declare function getUserPurchaseRecordInfo(payrollProgram: Program<ZebecPayrollIdl>, entCardConfigName: string, user: Address, commitment?: Commitment): Promise<UserPurchaseRecordInfo | null>;
 export declare function getCardPurchaseInfo(payrollProgram: Program<ZebecPayrollIdl>, entCardConfigName: string, user: Address, cardIndex: bigint, commitment?: Commitment): Promise<CardPurchaseInfo | null>;
+export declare function instantDisbursement(payrollProgram: Program<ZebecPayrollIdl>, params: InstantDisbursementParams): Promise<MultiTransactionPayload>;

package/dist/services.js

@@ -2,8 +2,8 @@ import { AnchorProvider, translateAddress, utils, } from "@coral-xyz/anchor";
 import { fetchMetadata, MPL_TOKEN_METADATA_PROGRAM_ID, } from "@metaplex-foundation/mpl-token-metadata";
 import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
 import { fromWeb3JsPublicKey, toWeb3JsPublicKey, } from "@metaplex-foundation/umi-web3js-adapters";
-import { createCloseAccountInstruction, createSyncNativeInstruction, } from "@solana/spl-token";
-import { AddressLookupTableAccount, ComputeBudgetProgram, Ed25519Program, Keypair, PublicKey, SystemProgram, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
+import { createCloseAccountInstruction, createSyncNativeInstruction, createTransferInstruction, } from "@solana/spl-token";
+import { AddressLookupTableAccount, ComputeBudgetProgram, Ed25519Program, Keypair, LAMPORTS_PER_SOL, PublicKey, SystemProgram, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
 import { assertBufferSize, bpsToPercent, percentToBps, } from "@zebec-network/core-utils";
 import { createAssociatedTokenAccountInstruction, getAssociatedTokenAddressSync, getMintDecimals, MultiTransactionPayload, TEN_BIGNUM, TransactionPayload, UNITS_PER_USDC, USDC_DECIMALS, WSOL, } from "@zebec-network/solana-common";
 import { BigNumber } from "bignumber.js";
@@ -1182,3 +1182,50 @@ export async function getCardPurchaseInfo(payrollProgram, entCardConfigName, use
         purchasedAt: info.purchaseAt.toNumber(),
     };
 }
+export async function instantDisbursement(payrollProgram, params) {
+    const sender = translateAddress(params.sender);
+    const feePayer = params.feePayer ? translateAddress(params.feePayer) : sender;
+    if (params.recipients.length === 0) {
+        throw new Error("At least one recipient is required");
+    }
+    const chunkSize = params.chunkSize ?? (params.isNative ? 20 : 5);
+    const chunks = [];
+    for (let i = 0; i < params.recipients.length; i += chunkSize) {
+        chunks.push(params.recipients.slice(i, i + chunkSize));
+    }
+    const transactionData = await Promise.all(chunks.map(async (chunk) => {
+        const instructions = [];
+        if (params.isNative) {
+            for (const recipient of chunk) {
+                const receiver = translateAddress(recipient.address);
+                const amount = BigNumber(recipient.amount)
+                    .times(LAMPORTS_PER_SOL)
+                    .toFixed(0);
+                instructions.push(SystemProgram.transfer({
+                    fromPubkey: sender,
+                    toPubkey: receiver,
+                    lamports: BigInt(amount),
+                }));
+            }
+        }
+        else {
+            const token = translateAddress(params.token);
+            const decimals = await getMintDecimals(payrollProgram.provider.connection, token);
+            const senderAta = getAssociatedTokenAddressSync(token, sender, true);
+            for (const recipient of chunk) {
+                const receiver = translateAddress(recipient.address);
+                const receiverAta = getAssociatedTokenAddressSync(token, receiver, true);
+                const amount = BigNumber(recipient.amount)
+                    .times(BigNumber(10).pow(decimals))
+                    .toFixed(0);
+                const receiverAtaInfo = await payrollProgram.provider.connection.getAccountInfo(receiverAta);
+                if (!receiverAtaInfo) {
+                    instructions.push(createAssociatedTokenAccountInstruction(feePayer, receiverAta, receiver, token));
+                }
+                instructions.push(createTransferInstruction(senderAta, receiverAta, sender, BigInt(amount)));
+            }
+        }
+        return { instructions };
+    }));
+    return createMultiTransactionPayload(payrollProgram, feePayer, transactionData);
+}

package/dist/types.d.ts

@@ -355,6 +355,20 @@ export type SwapAndCreateCardParams = {
     quoteInfo: QuoteInfo;
     wrapAndUnwrapWsol?: boolean;
 };
+export type InstantDisbursementRecipient = {
+    address: Address;
+    amount: Numeric;
+};
+export type InstantDisbursementParams = {
+    sender: Address;
+    feePayer?: Address;
+    /** SPL token mint. Ignored when isNative is true (uses SOL). */
+    token: Address;
+    isNative: boolean;
+    recipients: InstantDisbursementRecipient[];
+    /** Max recipients per transaction. Defaults to 5 for SPL, 20 for native SOL. */
+    chunkSize?: number;
+};
 export type CardPurchaseInfo = {
     index: bigint;
     buyer: Address;

package/package.json

@@ -45,5 +45,5 @@
 	},
 	"type": "module",
 	"types": "dist/index.d.ts",
-	"version": "2.7.0"
+	"version": "2.8.0"
 }