0xtrails 0.0.1 → 0.0.2

package/src/gasless.ts

@@ -0,0 +1,545 @@
+import type {
+  Account,
+  Address,
+  Chain,
+  Hex,
+  PublicClient,
+  WalletClient,
+} from "viem"
+import {
+  encodeFunctionData,
+  erc20Abi,
+  getAddress,
+  maxUint256,
+  parseAbi,
+} from "viem"
+import { PERMIT_ABI, TRANSFER_ABI, TRANSFER_FROM_ABI } from "./abi.js"
+import { attemptSwitchChain } from "./chainSwitch.js"
+
+export function splitSignature(signature: `0x${string}`): {
+  r: `0x${string}`
+  s: `0x${string}`
+  v: number
+} {
+  const sig = signature.slice(2)
+  const r = `0x${sig.slice(0, 64)}` as `0x${string}`
+  const s = `0x${sig.slice(64, 128)}` as `0x${string}`
+  const v = parseInt(sig.slice(128, 130), 16)
+  return { r, s, v }
+}
+
+export type PermitCalldataParams = {
+  signer: `0x${string}`
+  spender: `0x${string}`
+  amount: bigint
+  deadline: bigint
+  signature: `0x${string}`
+}
+
+export function getPermitCalldata({
+  signer,
+  spender,
+  amount,
+  deadline,
+  signature,
+}: PermitCalldataParams): Hex {
+  const { r, s, v } = splitSignature(signature)
+
+  // Encode permit call
+  const permitCalldata = encodeFunctionData({
+    abi: [PERMIT_ABI],
+    functionName: "permit",
+    args: [signer, spender, amount, deadline, v, r, s],
+  })
+
+  return permitCalldata
+}
+
+export type TransferFromCalldataParams = {
+  signer: `0x${string}`
+  spender: `0x${string}`
+  amount: bigint
+}
+
+export function getTransferFromCalldata({
+  signer,
+  spender,
+  amount,
+}: TransferFromCalldataParams): Hex {
+  // Encode transferFrom call
+  const transferFromCalldata = encodeFunctionData({
+    abi: [TRANSFER_FROM_ABI],
+    functionName: "transferFrom",
+    args: [signer, spender, amount],
+  })
+
+  return transferFromCalldata
+}
+
+export type TransferCalldataParams = {
+  recipient: `0x${string}`
+  amount: bigint
+}
+
+export function getTransferCalldata({
+  recipient,
+  amount,
+}: TransferCalldataParams): Hex {
+  // Encode transfer call to recipient
+  const transferCalldata = encodeFunctionData({
+    abi: [TRANSFER_ABI],
+    functionName: "transfer",
+    args: [recipient, amount],
+  })
+
+  return transferCalldata
+}
+
+export function getPermitCalls(
+  connectedAccount: `0x${string}`,
+  delegatorSmartAccountAddress: `0x${string}`,
+  amount: bigint,
+  deadline: bigint,
+  signature: `0x${string}`,
+  recipient: `0x${string}`,
+  tokenAddress: `0x${string}`,
+): { to: `0x${string}`; data: `0x${string}`; value: string }[] {
+  const permitCalldata = getPermitCalldata({
+    signer: connectedAccount,
+    spender: delegatorSmartAccountAddress,
+    amount,
+    deadline,
+    signature,
+  })
+  const transferFromCalldata = getTransferFromCalldata({
+    signer: connectedAccount,
+    spender: delegatorSmartAccountAddress,
+    amount,
+  })
+  const transferCalldata = getTransferCalldata({ recipient, amount })
+
+  return [permitCalldata, transferFromCalldata, transferCalldata].map(
+    (call) => ({
+      to: tokenAddress,
+      data: call,
+      value: "0",
+    }),
+  )
+}
+
+export type GetPermitSignatureParams = {
+  publicClient: PublicClient
+  walletClient: WalletClient
+  signer: `0x${string}`
+  spender: `0x${string}`
+  tokenAddress: `0x${string}`
+  amount: bigint
+  chain: Chain
+  deadline?: bigint
+}
+
+export async function getPermitSignature({
+  publicClient,
+  walletClient,
+  signer,
+  spender,
+  tokenAddress,
+  amount,
+  chain,
+  deadline = BigInt(Math.floor(Date.now() / 1000) + 3600), // 1 hour from now
+}: GetPermitSignatureParams): Promise<{
+  signature: `0x${string}`
+  deadline: bigint
+  v: number
+  r: `0x${string}`
+  s: `0x${string}`
+}> {
+  if (!walletClient.account) {
+    throw new Error("No account found")
+  }
+
+  // Get permit signature from connected account
+  const nonce = await publicClient.readContract({
+    address: tokenAddress as `0x${string}`,
+    abi: [
+      {
+        name: "nonces",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "owner", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+      },
+    ],
+    functionName: "nonces",
+    args: [signer],
+  })
+
+  const name = (await publicClient.readContract({
+    address: tokenAddress as `0x${string}`,
+    abi: [
+      {
+        name: "name",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "string" }],
+      },
+    ],
+    functionName: "name",
+  })) as string
+
+  let version = "1" // fallback default
+  try {
+    version = (await publicClient.readContract({
+      address: tokenAddress as `0x${string}`,
+      abi: [
+        {
+          name: "version",
+          type: "function",
+          stateMutability: "view",
+          inputs: [],
+          outputs: [{ name: "", type: "string" }],
+        },
+      ],
+      functionName: "version",
+    })) as string
+  } catch {
+    console.warn(
+      "[trails-sdk] Token does not implement version(), defaulting to '1'",
+    )
+  }
+
+  const domain = {
+    name,
+    version,
+    chainId: chain.id,
+    verifyingContract: tokenAddress as `0x${string}`,
+  }
+
+  const types = {
+    Permit: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "nonce", type: "uint256" },
+      { name: "deadline", type: "uint256" },
+    ],
+  }
+
+  // Create permit data
+  const permitData = {
+    owner: signer,
+    spender: spender,
+    value: amount,
+    nonce: nonce,
+    deadline: deadline,
+  }
+
+  await attemptSwitchChain({
+    walletClient,
+    desiredChainId: chain.id,
+  })
+
+  console.log("[trails-sdk] Requesting permit signature...")
+
+  const signature = await walletClient.signTypedData({
+    account: walletClient.account,
+    domain,
+    types,
+    primaryType: "Permit",
+    message: permitData,
+  })
+
+  const { v, r, s } = splitSignature(signature)
+
+  return { signature, deadline, v, r, s }
+}
+
+export type GetDepositToIntentWithPermitCalldataParams = {
+  user: `0x${string}`
+  token: `0x${string}`
+  amount: bigint
+  intentAddress: `0x${string}`
+  deadline: bigint
+  permitAmount: bigint
+  // permit signature
+  v: number
+  r: `0x${string}`
+  s: `0x${string}`
+  // intent signature
+  sigV: number
+  sigR: `0x${string}`
+  sigS: `0x${string}`
+}
+
+export function getDepositToIntentWithPermitCalldata({
+  user,
+  token,
+  amount,
+  intentAddress,
+  deadline,
+  permitAmount,
+  v,
+  r,
+  s,
+  sigV,
+  sigR,
+  sigS,
+}: GetDepositToIntentWithPermitCalldataParams): Hex {
+  const abi = parseAbi([
+    "function depositToIntentWithPermit(address user, address token, uint256 amount, uint256 permitAmount, address intentAddress, uint256 deadline, uint8 v, bytes32 r, bytes32 s, uint8 sigV, bytes32 sigR, bytes32 sigS)",
+  ])
+
+  return encodeFunctionData({
+    abi,
+    functionName: "depositToIntentWithPermit",
+    args: [
+      user,
+      token,
+      amount,
+      permitAmount,
+      intentAddress,
+      deadline,
+      v,
+      r,
+      s,
+      sigV,
+      sigR,
+      sigS,
+    ],
+  })
+}
+
+export type GetDepositToIntentWithoutPermitCalldataParams = {
+  user: `0x${string}`
+  token: `0x${string}`
+  amount: bigint
+  intentAddress: `0x${string}`
+  deadline: bigint
+  sigV: number
+  sigR: `0x${string}`
+  sigS: `0x${string}`
+}
+
+export function getDepositToIntentWithoutPermitCalldata({
+  user,
+  token,
+  amount,
+  intentAddress,
+  deadline,
+  sigV,
+  sigR,
+  sigS,
+}: GetDepositToIntentWithoutPermitCalldataParams): Hex {
+  const abi = parseAbi([
+    "function depositToIntent(address user, address token, uint256 amount, address intentAddress, uint256 deadline, uint8 sigV, bytes32 sigR, bytes32 sigS)",
+  ])
+
+  return encodeFunctionData({
+    abi,
+    functionName: "depositToIntent",
+    args: [user, token, amount, intentAddress, deadline, sigV, sigR, sigS],
+  })
+}
+
+export type GetDepositToIntentCallsParams = {
+  publicClient: PublicClient
+  walletClient: WalletClient
+  account: Account
+  intentEntrypoint: `0x${string}`
+  depositTokenAddress: `0x${string}`
+  depositTokenAmount: bigint
+  depositRecipient: `0x${string}`
+  chain: Chain
+}
+
+export async function getDepositToIntentCalls({
+  publicClient,
+  walletClient,
+  account,
+  intentEntrypoint,
+  depositTokenAddress,
+  depositTokenAmount,
+  depositRecipient,
+  chain,
+}: GetDepositToIntentCallsParams): Promise<
+  Array<{ to: `0x${string}`; data: `0x${string}`; value: `0x${string}` }>
+> {
+  const permitAmount = maxUint256
+  const needsApproval = await getNeedsIntentEntrypointApproval({
+    client: publicClient,
+    token: depositTokenAddress,
+    account: account.address,
+    entrypoint: intentEntrypoint,
+    amount: BigInt(depositTokenAmount),
+  })
+
+  const deadline = BigInt(Math.floor(Date.now() / 1000) + 3600) // 1 hour from now
+
+  let approvalSignature = null
+  if (needsApproval) {
+    approvalSignature = await getPermitSignature({
+      publicClient,
+      walletClient,
+      signer: account.address,
+      spender: intentEntrypoint,
+      tokenAddress: depositTokenAddress as `0x${string}`,
+      amount: permitAmount,
+      chain,
+      deadline,
+    })
+  }
+
+  const {
+    v: signedIntentV,
+    r: signedIntentR,
+    s: signedIntentS,
+  } = await signIntent({
+    client: walletClient,
+    intentParams: {
+      user: account.address,
+      token: depositTokenAddress as `0x${string}`,
+      amount: BigInt(depositTokenAmount),
+      intentAddress: depositRecipient as `0x${string}`,
+      deadline,
+      chainId: chain.id,
+      contractAddress: intentEntrypoint,
+    },
+  })
+
+  let calldata = null
+  if (approvalSignature) {
+    calldata = getDepositToIntentWithPermitCalldata({
+      user: account.address,
+      token: depositTokenAddress as `0x${string}`,
+      amount: BigInt(depositTokenAmount),
+      permitAmount,
+      intentAddress: depositRecipient as `0x${string}`,
+      deadline,
+      v: approvalSignature.v,
+      r: approvalSignature.r,
+      s: approvalSignature.s,
+      sigV: signedIntentV,
+      sigR: signedIntentR,
+      sigS: signedIntentS,
+    })
+  } else {
+    calldata = getDepositToIntentWithoutPermitCalldata({
+      user: account.address,
+      token: depositTokenAddress as `0x${string}`,
+      amount: BigInt(depositTokenAmount),
+      intentAddress: depositRecipient as `0x${string}`,
+      deadline,
+      sigV: signedIntentV,
+      sigR: signedIntentR,
+      sigS: signedIntentS,
+    })
+  }
+
+  const calls = [
+    {
+      to: intentEntrypoint as `0x${string}`,
+      data: calldata as `0x${string}`,
+      value: "0" as `0x${string}`,
+    },
+  ]
+
+  return calls
+}
+
+export type GetNeedsIntentEntrypointApprovalParams = {
+  client: PublicClient
+  token: Address
+  account: Address
+  entrypoint: Address
+  amount: bigint
+}
+
+export async function getNeedsIntentEntrypointApproval({
+  client,
+  token,
+  account,
+  entrypoint,
+  amount,
+}: GetNeedsIntentEntrypointApprovalParams): Promise<boolean> {
+  const allowance = await client.readContract({
+    address: token,
+    abi: erc20Abi,
+    functionName: "allowance",
+    args: [getAddress(account), getAddress(entrypoint)],
+  })
+
+  return allowance < amount
+}
+
+export type IntentParams = {
+  user: `0x${string}`
+  token: `0x${string}`
+  amount: bigint
+  intentAddress: `0x${string}`
+  deadline: bigint
+  chainId: number
+  contractAddress: `0x${string}`
+}
+
+export type SignIntentParams = {
+  client: WalletClient
+  intentParams: IntentParams
+}
+
+export async function signIntent({
+  client,
+  intentParams,
+}: SignIntentParams): Promise<{
+  signature: `0x${string}`
+  v: number
+  r: `0x${string}`
+  s: `0x${string}`
+}> {
+  const {
+    user,
+    token,
+    amount,
+    intentAddress,
+    deadline,
+    chainId,
+    contractAddress,
+  } = intentParams
+
+  const domain = {
+    name: "IntentEntrypoint",
+    version: "1",
+    chainId,
+    verifyingContract: contractAddress, // ✅ This fixes the signature mismatch
+  }
+
+  const types = {
+    Intent: [
+      { name: "user", type: "address" },
+      { name: "token", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "intentAddress", type: "address" },
+      { name: "deadline", type: "uint256" },
+    ],
+  }
+
+  const message = {
+    user: getAddress(user),
+    token: getAddress(token),
+    amount: BigInt(amount),
+    intentAddress: getAddress(intentAddress),
+    deadline: BigInt(deadline),
+  }
+
+  const signature = await client.signTypedData({
+    account: client.account as Account,
+    domain,
+    types,
+    primaryType: "Intent",
+    message,
+  })
+
+  const { v, r, s } = splitSignature(signature)
+
+  return { signature, v, r, s }
+}

package/src/index.ts

@@ -0,0 +1,48 @@
+// Be explicit about what we export
+
+export { getAPIClient, useAPIClient } from "./apiClient.js"
+export {
+  getSupportedChains,
+  useSupportedChains,
+} from "./chains.js"
+export {
+  getIndexerGatewayClient,
+  useIndexerGatewayClient,
+} from "./indexerClient.js"
+export type {
+  GetIntentCallsPayloadsReturn,
+  OriginCallParams,
+  QuoteProvider,
+  TrailsFee,
+} from "./intents.js"
+export {
+  calculateIntentAddress,
+  calculateOriginAndDestinationIntentAddresses,
+  commitIntentConfig,
+  getIntentCallsPayloads,
+} from "./intents.js"
+export type {
+  MetaTxn,
+  MetaTxnStatus,
+} from "./metaTxnMonitor.js"
+export { prepareSend, useQuote } from "./prepareSend.js"
+export {
+  getAccountTotalBalanceUsd,
+  getHasSufficientBalanceToken,
+  getHasSufficientBalanceUsd,
+  useAccountTotalBalanceUsd,
+  useHasSufficientBalanceToken,
+  useHasSufficientBalanceUsd,
+  useTokenBalances,
+} from "./tokenBalances.js"
+export type {
+  NativeTokenBalance,
+  TokenBalance,
+} from "./tokenBalances.js"
+export {
+  getSupportedTokens,
+  useSupportedTokens,
+  useTokenList,
+} from "./tokens.js"
+export { useTrails } from "./trails.js"
+export type { WagmiAccount } from "./trails.js"

package/src/indexerClient.ts

@@ -0,0 +1,36 @@
+import { useConfig } from "@0xsequence/hooks"
+import { SequenceIndexerGateway } from "@0xsequence/indexer"
+import { useMemo } from "react"
+import { DEFAULT_INDEXER_GATEWAY_URL } from "./constants.js"
+
+export type IndexerGatewayConfig = {
+  indexerGatewayUrl?: string
+  projectAccessKey?: string
+  jwt?: string
+}
+
+export function getIndexerGatewayClient({
+  indexerGatewayUrl = DEFAULT_INDEXER_GATEWAY_URL,
+  projectAccessKey,
+  jwt,
+}: IndexerGatewayConfig): SequenceIndexerGateway {
+  return new SequenceIndexerGateway(
+    indexerGatewayUrl as string,
+    projectAccessKey,
+    jwt,
+  )
+}
+
+export const useIndexerGatewayClient = (config?: IndexerGatewayConfig) => {
+  const { projectAccessKey, jwt, env } = useConfig()
+
+  const indexerGatewayClient = useMemo(() => {
+    return getIndexerGatewayClient({
+      indexerGatewayUrl: config?.indexerGatewayUrl ?? env.indexerGatewayUrl,
+      projectAccessKey: config?.projectAccessKey ?? projectAccessKey,
+      jwt: config?.jwt ?? jwt,
+    })
+  }, [projectAccessKey, jwt, env.indexerGatewayUrl, config])
+
+  return indexerGatewayClient
+}