For most use cases, use the unified deposit
workflow which
handles authorization automatically.
Import
import { prepareDepositWithPermitTxData } from '@paxoslabs/amplify-sdk'
Usage
const txData = await prepareDepositWithPermitTxData({
yieldType: YieldType.CORE,
depositAsset: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
depositAmount: '1000',
to: '0x...',
chainId: 1,
signature: '0x...', // From wallet signing
deadline: 1234567890n,
})
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
yieldType | YieldType | Yes | Yield strategy type (CORE, TREASURY, or FRONTIER) |
depositAsset | Address | Yes | Token contract address to deposit |
depositAmount | string | Yes | Amount to deposit as decimal string (e.g., "100.50") |
to | Address | Yes | Recipient address for vault shares |
chainId | number | Yes | Blockchain network ID |
signature | Hex | Yes | Permit signature from wallet signing |
deadline | bigint | Yes | Permit deadline (must match signed deadline) |
slippage | number | No | Slippage tolerance in basis points (default: 50) |
distributorCode | string | No | Distributor code for fee attribution |
interface PrepareDepositWithPermitTxDataParams {
/** Yield strategy type (e.g., YieldType.CORE) */
yieldType: YieldType
/** Token contract address to deposit */
depositAsset: Address
/** Amount to deposit as decimal string */
depositAmount: string
/** Recipient address for vault shares */
to: Address
/** Blockchain network ID */
chainId: ChainId
/** Permit signature (hex string from wallet signing) */
signature: Hex
/** Permit deadline (must match signature deadline) */
deadline: bigint
/** Slippage in basis points (default: 50 = 0.5%) */
slippage?: number
/** Distributor code for fee attribution */
distributorCode?: string
}
Return Type
- Type Definition
- Example Response
interface UnencodedDepositWithPermitData {
/** Depositor contract address */
address: Address;
/** Chain ID for the transaction */
chainId: number;
/** Transaction data (nested — use data.abi, data.functionName, data.args) */
data: {
/** Contract ABI */
abi: Abi;
/** Function name to call */
functionName: "depositWithPermit";
/** Encoded function arguments */
args: readonly [Address, bigint, bigint, Address, Hex, bigint, number, Hex, Hex];
};
}
{
address: "0x1234...5678",
chainId: 1,
data: {
abi: [...], // CommunityCodeDepositor ABI
functionName: "depositWithPermit",
args: [
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // depositAsset
1000000000n, // depositAmount (in base units)
995000000n, // minimumMint (with slippage applied)
"0xUser...Addr", // to (recipient)
"0x", // distributorCode (hex-encoded)
1234567890n, // deadline
28, // v
"0xr...", // r
"0xs...", // s
],
},
}
The return structure is nested: ABI and args live under
.data, not at the top level. When using writeContract, pass txData.data.abi, txData.data.functionName, and txData.data.args. When using sendTransaction, encode via encodeFunctionData({ abi: txData.data.abi, functionName: txData.data.functionName, args: txData.data.args }).Examples
- Privy
- Wagmi
- Viem
import { encodeFunctionData } from "viem";
import { usePrivy, useWallets } from "@privy-io/react-auth";
import {
prepareDepositAuthorization,
prepareDepositWithPermitTxData,
isPermitAuth,
YieldType,
} from "@paxoslabs/amplify-sdk";
const { sendTransaction } = usePrivy();
const { wallets } = useWallets();
const wallet = wallets[0];
const owner = wallet.address as `0x${string}`;
const params = {
yieldType: YieldType.CORE,
depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" as const,
depositAmount: "1000",
to: owner,
chainId: 1,
};
// Step 1: Get permit data
const auth = await prepareDepositAuthorization(params);
if (isPermitAuth(auth)) {
// Step 2: Sign the permit
const provider = await wallet.getEthereumProvider();
const signature = await provider.request({
method: "eth_signTypedData_v4",
params: [owner, JSON.stringify(auth.permitData)],
}) as `0x${string}`;
// Step 3: Execute deposit with permit
const txData = await prepareDepositWithPermitTxData({
...params,
signature,
deadline: BigInt(auth.permitData.message.deadline),
});
await sendTransaction({
chainId: txData.chainId,
to: txData.address,
data: encodeFunctionData({
abi: txData.data.abi,
functionName: txData.data.functionName,
args: txData.data.args,
}),
});
}
import { useAccount, useWriteContract, useSignTypedData } from "wagmi";
import {
prepareDepositAuthorization,
prepareDepositWithPermitTxData,
isPermitAuth,
YieldType,
} from "@paxoslabs/amplify-sdk";
const { address, chainId } = useAccount();
const { writeContractAsync } = useWriteContract();
const { signTypedDataAsync } = useSignTypedData();
const params = {
yieldType: YieldType.CORE,
depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" as const,
depositAmount: "1000",
to: address!,
chainId: chainId!,
};
const auth = await prepareDepositAuthorization(params);
if (isPermitAuth(auth)) {
const signature = await signTypedDataAsync(auth.permitData);
const txData = await prepareDepositWithPermitTxData({
...params,
signature,
deadline: BigInt(auth.permitData.message.deadline),
});
await writeContractAsync({
address: txData.address,
abi: txData.data.abi,
functionName: txData.data.functionName,
args: txData.data.args,
account: address,
});
}
import { createWalletClient, custom } from "viem";
import { mainnet } from "viem/chains";
import {
prepareDepositAuthorization,
prepareDepositWithPermitTxData,
isPermitAuth,
YieldType,
} from "@paxoslabs/amplify-sdk";
const client = createWalletClient({
account,
chain: mainnet,
transport: custom(window.ethereum),
});
const params = {
yieldType: YieldType.CORE,
depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" as const,
depositAmount: "1000",
to: account,
chainId: mainnet.id,
};
const auth = await prepareDepositAuthorization(params);
if (isPermitAuth(auth)) {
const signature = await client.signTypedData({
account,
...auth.permitData,
});
const txData = await prepareDepositWithPermitTxData({
...params,
signature,
deadline: BigInt(auth.permitData.message.deadline),
});
await client.writeContract({
address: txData.address,
abi: txData.data.abi,
functionName: txData.data.functionName,
args: txData.data.args,
account,
});
}
Permit Support
Not all tokens support EIP-2612 permits. UseprepareDepositAuthorization() to check:
| Token | Supports Permit |
|---|---|
| USDC | Yes |
| USDG | Yes |
| pyUSD | Yes |
| USDT | No |
Smart contract wallets (like Privy Smart Wallets or Safe) cannot sign permits.
Use the approval flow with transaction batching instead.
Error Handling
| Error Message Pattern | Description | Resolution |
|---|---|---|
"SDK not initialized" | SDK not initialized | Call initAmplifySDK() first |
"does not support EIP-2612 permit" | Token lacks permit support | Use approval flow instead |
"Invalid permit signature format" | Signature parsing failed | Re-sign with correct typed data |
"Invalid slippage value" | Slippage outside 0–10000 bps | Provide value between 0 and 10000 |
Related
- Deposit Workflow - Unified deposit API
- prepareDepositTxData - Standard deposits
- DepositAuthMethod - Authorization types