[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77KBDR4WEDQVKWA9MSTVN5W":3,"skill-same:01M77KBDR4WEDQVKWA9MSTVN5W":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":48},"01M77KBDR4WEDQVKWA9MSTVN5W","dapp",null,"Stellar dApp \u002F frontend development. Covers the JavaScript stellar-sdk (browser + Node.js), Freighter wallet, Stellar Wallets Kit (multi-wallet), Wallet Standard, smart accounts with passkeys, transaction building \u002F signing \u002F submission, smart contract invocation from the client, simulation, and error handling. Use when building a React\u002FNext.js\u002FNode.js app that talks to Stellar - classic operations or smart contracts.","WritzProtocol\u002Fwritz","WritzProtocol","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F296057967?v=4","01M77K5N0T3073T814APZTAXM4","Writz Protocol","01M77K5N1WQ551ZKCCK9MR379A",6,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fdapp\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: dapp\ndescription: Stellar dApp \u002F frontend development. Covers the JavaScript stellar-sdk (browser + Node.js), Freighter wallet, Stellar Wallets Kit (multi-wallet), Wallet Standard, smart accounts with passkeys, transaction building \u002F signing \u002F submission, smart contract invocation from the client, simulation, and error handling. Use when building a React\u002FNext.js\u002FNode.js app that talks to Stellar - classic operations or smart contracts.\nuser-invocable: true\nargument-hint: \"[dapp task]\"\n---\n\n# Stellar dApp \u002F Frontend\n\nClient-side development with `@stellar\u002Fstellar-sdk`, wallet connection, signing, and submitting transactions. Covers both classic Stellar operations and smart contract invocation from the browser or Node.js.\n\n## When to use this skill\n- Connecting Freighter or other wallets via Stellar Wallets Kit\n- Building, simulating, signing, and submitting transactions\n- Invoking Stellar smart contracts from a frontend\n- Implementing smart accounts with passkeys\n- Handling network passphrases (Mainnet \u002F Testnet \u002F local)\n\n## Related skills\n- Writing the contract being invoked → `..\u002Fsmart-contracts\u002FSKILL.md`\n- Issuing assets and managing trustlines → `..\u002Fassets\u002FSKILL.md`\n- Querying chain state via RPC \u002F Horizon → `..\u002Fdata\u002FSKILL.md`\n- Building paid APIs or agent payment clients → `..\u002Fagentic-payments\u002FSKILL.md`\n- SEPs the wallet\u002Fanchor flows depend on → `..\u002Fstandards\u002FSKILL.md`\n\n---\n\n\n## Goals\n- Single SDK instance for the app (RPC\u002FHorizon + transaction building)\n- Freighter wallet integration (or multi-wallet via Stellar Wallets Kit)\n- Clean separation of client\u002Fserver in Next.js\n- Transaction sending with proper confirmation handling\n\n## Quick Navigation\n- SDK setup and env config: [SDK Initialization](#sdk-initialization)\n- Wallet integrations: [Wallet Integration](#wallet-integration)\n- Tx build\u002Fsend patterns: [Transaction Building](#transaction-building), [Transaction Submission](#transaction-submission)\n- React + Next.js patterns: [React Components](#react-components), [Next.js App Router Setup](#nextjs-app-router-setup)\n- Smart wallets\u002Fpasskeys: [Smart Accounts (Passkey Wallets)](#smart-accounts-passkey-wallets)\n- Production UX checklist: [Transaction UX Checklist](#transaction-ux-checklist)\n\n## Recommended Dependencies\n\n> **Requires Node.js 20+** - the Stellar SDK dropped Node 18 support.\n\n```bash\nnpm install @stellar\u002Fstellar-sdk @stellar\u002Ffreighter-api\n# Or for multi-wallet support:\nnpm install @stellar\u002Fstellar-sdk @creit.tech\u002Fstellar-wallets-kit\n```\n\n## SDK Initialization\n\n> For the full API reference (RPC methods, Horizon endpoints, migration guide), see [api-rpc-horizon.md](..\u002Fdata\u002FSKILL.md).\n\n### Basic Setup\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\n\n\u002F\u002F For Testnet\nconst testnetServer = new StellarSdk.Horizon.Server(\"https:\u002F\u002Fhorizon-testnet.stellar.org\");\nconst testnetRpc = new StellarSdk.rpc.Server(\"https:\u002F\u002Fsoroban-testnet.stellar.org\");\nconst testnetNetworkPassphrase = StellarSdk.Networks.TESTNET;\n\n\u002F\u002F For Mainnet\nconst mainnetServer = new StellarSdk.Horizon.Server(\"https:\u002F\u002Fhorizon.stellar.org\");\nconst mainnetRpcUrl = process.env.NEXT_PUBLIC_STELLAR_MAINNET_RPC_URL;\nif (!mainnetRpcUrl) throw new Error(\"Missing NEXT_PUBLIC_STELLAR_MAINNET_RPC_URL\");\nconst mainnetRpc = new StellarSdk.rpc.Server(mainnetRpcUrl); \u002F\u002F set from your chosen RPC provider\nconst mainnetNetworkPassphrase = StellarSdk.Networks.PUBLIC;\n```\n\n### Environment Configuration\n> Use a provider-specific mainnet RPC URL (see: https:\u002F\u002Fdevelopers.stellar.org\u002Fdocs\u002Fdata\u002Fapis\u002Frpc\u002Fproviders).\n\n```typescript\n\u002F\u002F lib\u002Fstellar.ts\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\n\nconst NETWORK = process.env.NEXT_PUBLIC_STELLAR_NETWORK || \"testnet\";\n\nconst requireEnv = (name: string): string => {\n  const value = process.env[name];\n  if (!value) throw new Error(`Missing required env var: ${name}`);\n  return value;\n};\n\nexport const config = {\n  testnet: {\n    horizonUrl: \"https:\u002F\u002Fhorizon-testnet.stellar.org\",\n    rpcUrl: \"https:\u002F\u002Fsoroban-testnet.stellar.org\",\n    networkPassphrase: StellarSdk.Networks.TESTNET,\n    friendbotUrl: \"https:\u002F\u002Ffriendbot.stellar.org\",\n  },\n  mainnet: {\n    horizonUrl: \"https:\u002F\u002Fhorizon.stellar.org\",\n    rpcUrl: requireEnv(\"NEXT_PUBLIC_STELLAR_MAINNET_RPC_URL\"),\n    networkPassphrase: StellarSdk.Networks.PUBLIC,\n    friendbotUrl: null,\n  },\n}[NETWORK]!;\n\nexport const horizon = new StellarSdk.Horizon.Server(config.horizonUrl);\nexport const rpc = new StellarSdk.rpc.Server(config.rpcUrl);\n```\n\n## Wallet Integration\n\n### Freighter (Primary Browser Wallet)\n```typescript\n\u002F\u002F hooks\u002FuseFreighter.ts\nimport { useState, useEffect, useCallback } from \"react\";\nimport {\n  isConnected,\n  getAddress,\n  requestAccess,\n  signTransaction,\n  getNetwork,\n} from \"@stellar\u002Ffreighter-api\";\n\nexport function useFreighter() {\n  const [connected, setConnected] = useState(false);\n  const [address, setAddress] = useState\u003Cstring | null>(null);\n  const [network, setNetwork] = useState\u003Cstring | null>(null);\n\n  useEffect(() => {\n    checkConnection();\n  }, []);\n\n  const checkConnection = async () => {\n    const { isConnected: installed, error } = await isConnected();\n    if (error || !installed) return;\n\n    \u002F\u002F getAddress returns address: \"\" until the app has been granted access,\n    \u002F\u002F so a non-empty address means we're already authorized.\n    const { address: addr, error: addressError } = await getAddress();\n    if (addressError || !addr) return;\n\n    const { network: net, error: networkError } = await getNetwork();\n    if (networkError) return;\n    setConnected(true);\n    setAddress(addr);\n    setNetwork(net);\n  };\n\n  const connect = useCallback(async () => {\n    const { isConnected: installed, error } = await isConnected();\n    if (error || !installed) {\n      throw new Error(\"Freighter extension not installed\");\n    }\n\n    \u002F\u002F requestAccess prompts the user and returns the granted address.\n    const { address: addr, error: accessError } = await requestAccess();\n    if (accessError) throw new Error(accessError.message);\n\n    const { network: net, error: networkError } = await getNetwork();\n    if (networkError) throw new Error(networkError.message);\n    setConnected(true);\n    setAddress(addr);\n    setNetwork(net);\n\n    return addr;\n  }, []);\n\n  const disconnect = useCallback(() => {\n    setConnected(false);\n    setAddress(null);\n    setNetwork(null);\n  }, []);\n\n  const sign = useCallback(\n    async (xdr: string, networkPassphrase: string) => {\n      if (!connected) throw new Error(\"Wallet not connected\");\n      const { signedTxXdr, error } = await signTransaction(xdr, {\n        networkPassphrase,\n      });\n      if (error) throw new Error(error.message);\n      return signedTxXdr;\n    },\n    [connected]\n  );\n\n  return { connected, address, network, connect, disconnect, sign };\n}\n```\n\n### Stellar Wallets Kit (Multi-Wallet)\n```typescript\n\u002F\u002F hooks\u002FuseStellarWallet.ts\nimport { useState, useCallback } from \"react\";\nimport {\n  StellarWalletsKit,\n  WalletNetwork,\n  allowAllModules,\n  FREIGHTER_ID,\n  LOBSTR_ID,\n  XBULL_ID,\n} from \"@creit.tech\u002Fstellar-wallets-kit\";\n\nconst kit = new StellarWalletsKit({\n  network: WalletNetwork.TESTNET,\n  selectedWalletId: FREIGHTER_ID,\n  modules: allowAllModules(),\n});\n\nexport function useStellarWallet() {\n  const [address, setAddress] = useState\u003Cstring | null>(null);\n\n  const connect = useCallback(async () => {\n    await kit.openModal({\n      onWalletSelected: async (option) => {\n        kit.setWallet(option.id);\n        const { address } = await kit.getAddress();\n        setAddress(address);\n      },\n    });\n  }, []);\n\n  const disconnect = useCallback(() => {\n    setAddress(null);\n  }, []);\n\n  const sign = useCallback(async (xdr: string) => {\n    const { signedTxXdr } = await kit.signTransaction(xdr);\n    return signedTxXdr;\n  }, []);\n\n  return { address, connect, disconnect, sign, kit };\n}\n```\n\n## Transaction Building\n\n### Basic Payment\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { horizon, config } from \"@\u002Flib\u002Fstellar\";\n\nexport async function buildPaymentTx(\n  sourceAddress: string,\n  destinationAddress: string,\n  amount: string,\n  asset: StellarSdk.Asset = StellarSdk.Asset.native()\n) {\n  const account = await horizon.loadAccount(sourceAddress);\n\n  const transaction = new StellarSdk.TransactionBuilder(account, {\n    fee: StellarSdk.BASE_FEE,\n    networkPassphrase: config.networkPassphrase,\n  })\n    .addOperation(\n      StellarSdk.Operation.payment({\n        destination: destinationAddress,\n        asset: asset,\n        amount: amount,\n      })\n    )\n    .setTimeout(180)\n    .build();\n\n  return transaction.toXDR();\n}\n```\n\n### Smart Contract Invocation\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { rpc, config } from \"@\u002Flib\u002Fstellar\";\n\nexport async function invokeContract(\n  sourceAddress: string,\n  contractId: string,\n  method: string,\n  args: StellarSdk.xdr.ScVal[]\n) {\n  const account = await rpc.getAccount(sourceAddress);\n\n  const contract = new StellarSdk.Contract(contractId);\n\n  let transaction = new StellarSdk.TransactionBuilder(account, {\n    fee: StellarSdk.BASE_FEE,\n    networkPassphrase: config.networkPassphrase,\n  })\n    .addOperation(contract.call(method, ...args))\n    .setTimeout(180)\n    .build();\n\n  \u002F\u002F Simulate to get resource estimates\n  const simulation = await rpc.simulateTransaction(transaction);\n\n  if (StellarSdk.rpc.Api.isSimulationError(simulation)) {\n    throw new Error(`Simulation failed: ${simulation.error}`);\n  }\n\n  \u002F\u002F Assemble with proper resources\n  transaction = StellarSdk.rpc.assembleTransaction(\n    transaction,\n    simulation\n  ).build();\n\n  return transaction.toXDR();\n}\n```\n\n### Building ScVal Arguments\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\n\n\u002F\u002F Common conversions\nconst addressVal = StellarSdk.Address.fromString(address).toScVal();\nconst i128Val = StellarSdk.nativeToScVal(BigInt(amount), { type: \"i128\" });\nconst u32Val = StellarSdk.nativeToScVal(42, { type: \"u32\" });\nconst stringVal = StellarSdk.nativeToScVal(\"hello\", { type: \"string\" });\nconst symbolVal = StellarSdk.nativeToScVal(\"transfer\", { type: \"symbol\" });\n\n\u002F\u002F Struct\nconst structVal = StellarSdk.nativeToScVal(\n  { name: \"Token\", decimals: 7 },\n  {\n    type: {\n      name: [\"symbol\", null],\n      decimals: [\"u32\", null],\n    },\n  }\n);\n\n\u002F\u002F Vec\nconst vecVal = StellarSdk.nativeToScVal([1, 2, 3], { type: \"i128\" });\n```\n\n## Transaction Submission\n\n### Submit and Wait for Confirmation\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { rpc, horizon, config } from \"@\u002Flib\u002Fstellar\";\n\nexport async function submitTransaction(signedXdr: string) {\n  const transaction = StellarSdk.TransactionBuilder.fromXDR(\n    signedXdr,\n    config.networkPassphrase\n  );\n\n  \u002F\u002F For smart contract transactions, use RPC\n  if (transaction.operations.some(op => op.type === \"invokeHostFunction\")) {\n    return submitSorobanTransaction(signedXdr);\n  }\n\n  \u002F\u002F For classic transactions, use Horizon\n  return submitClassicTransaction(signedXdr);\n}\n\nasync function submitSorobanTransaction(signedXdr: string) {\n  const transaction = StellarSdk.TransactionBuilder.fromXDR(\n    signedXdr,\n    config.networkPassphrase\n  ) as StellarSdk.Transaction;\n\n  const response = await rpc.sendTransaction(transaction);\n\n  if (response.status === \"ERROR\") {\n    throw new Error(`Transaction failed: ${response.errorResult}`);\n  }\n\n  \u002F\u002F Poll for completion\n  let getResponse = await rpc.getTransaction(response.hash);\n  while (getResponse.status === \"NOT_FOUND\") {\n    await new Promise((resolve) => setTimeout(resolve, 1000));\n    getResponse = await rpc.getTransaction(response.hash);\n  }\n\n  if (getResponse.status === \"SUCCESS\") {\n    return {\n      hash: response.hash,\n      result: getResponse.returnValue,\n    };\n  }\n\n  throw new Error(`Transaction failed: ${getResponse.status}`);\n}\n\nasync function submitClassicTransaction(signedXdr: string) {\n  const transaction = StellarSdk.TransactionBuilder.fromXDR(\n    signedXdr,\n    config.networkPassphrase\n  ) as StellarSdk.Transaction;\n\n  const response = await horizon.submitTransaction(transaction);\n  return {\n    hash: response.hash,\n    ledger: response.ledger,\n  };\n}\n```\n\n## React Components\n\n### Connect Wallet Button\n```tsx\n\u002F\u002F components\u002FConnectButton.tsx\n\"use client\";\n\nimport { useFreighter } from \"@\u002Fhooks\u002FuseFreighter\";\n\nexport function ConnectButton() {\n  const { connected, address, connect, disconnect } = useFreighter();\n\n  if (connected && address) {\n    return (\n      \u003Cdiv className=\"flex items-center gap-2\">\n        \u003Cspan className=\"text-sm\">\n          {address.slice(0, 4)}...{address.slice(-4)}\n        \u003C\u002Fspan>\n        \u003Cbutton\n          onClick={disconnect}\n          className=\"px-4 py-2 bg-red-500 text-white rounded\"\n        >\n          Disconnect\n        \u003C\u002Fbutton>\n      \u003C\u002Fdiv>\n    );\n  }\n\n  return (\n    \u003Cbutton\n      onClick={connect}\n      className=\"px-4 py-2 bg-blue-500 text-white rounded\"\n    >\n      Connect Wallet\n    \u003C\u002Fbutton>\n  );\n}\n```\n\n### Send Payment Form\n```tsx\n\u002F\u002F components\u002FSendPayment.tsx\n\"use client\";\n\nimport { useState } from \"react\";\nimport { useFreighter } from \"@\u002Fhooks\u002FuseFreighter\";\nimport { buildPaymentTx, submitTransaction } from \"@\u002Flib\u002Ftransactions\";\n\nexport function SendPayment() {\n  const { address, sign } = useFreighter();\n  const [destination, setDestination] = useState(\"\");\n  const [amount, setAmount] = useState(\"\");\n  const [status, setStatus] = useState\u003Cstring | null>(null);\n  const [loading, setLoading] = useState(false);\n\n  const handleSubmit = async (e: React.FormEvent) => {\n    e.preventDefault();\n    if (!address) return;\n\n    setLoading(true);\n    setStatus(\"Building transaction...\");\n\n    try {\n      const xdr = await buildPaymentTx(address, destination, amount);\n\n      setStatus(\"Please sign in your wallet...\");\n      const signedXdr = await sign(xdr, config.networkPassphrase);\n\n      setStatus(\"Submitting transaction...\");\n      const result = await submitTransaction(signedXdr);\n\n      setStatus(`Success! Hash: ${result.hash}`);\n    } catch (error) {\n      setStatus(`Error: ${error.message}`);\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  return (\n    \u003Cform onSubmit={handleSubmit} className=\"space-y-4\">\n      \u003Cinput\n        type=\"text\"\n        placeholder=\"Destination Address\"\n        value={destination}\n        onChange={(e) => setDestination(e.target.value)}\n        className=\"w-full p-2 border rounded\"\n      \u002F>\n      \u003Cinput\n        type=\"text\"\n        placeholder=\"Amount (XLM)\"\n        value={amount}\n        onChange={(e) => setAmount(e.target.value)}\n        className=\"w-full p-2 border rounded\"\n      \u002F>\n      \u003Cbutton\n        type=\"submit\"\n        disabled={loading || !address}\n        className=\"w-full p-2 bg-blue-500 text-white rounded disabled:opacity-50\"\n      >\n        {loading ? \"Processing...\" : \"Send\"}\n      \u003C\u002Fbutton>\n      {status && \u003Cp className=\"text-sm\">{status}\u003C\u002Fp>}\n    \u003C\u002Fform>\n  );\n}\n```\n\n## Next.js App Router Setup\n\n### Provider Component\n```tsx\n\u002F\u002F app\u002Fproviders.tsx\n\"use client\";\n\nimport { ReactNode } from \"react\";\n\n\u002F\u002F Add any context providers here\nexport function Providers({ children }: { children: ReactNode }) {\n  return \u003C>{children}\u003C\u002F>;\n}\n```\n\n### Layout\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { Providers } from \".\u002Fproviders\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003Chtml lang=\"en\">\n      \u003Cbody>\n        \u003CProviders>{children}\u003C\u002FProviders>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  );\n}\n```\n\n## Data Fetching\n\n### Account Balance\n```typescript\nimport { horizon } from \"@\u002Flib\u002Fstellar\";\n\nexport async function getBalance(address: string) {\n  try {\n    const account = await horizon.loadAccount(address);\n    const nativeBalance = account.balances.find(\n      (b) => b.asset_type === \"native\"\n    );\n    return nativeBalance?.balance || \"0\";\n  } catch (error) {\n    if (error.response?.status === 404) {\n      return \"0\"; \u002F\u002F Account not funded\n    }\n    throw error;\n  }\n}\n```\n\n### Contract State\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { rpc } from \"@\u002Flib\u002Fstellar\";\n\nexport async function getContractData(\n  contractId: string,\n  key: StellarSdk.xdr.ScVal\n) {\n  const ledgerKey = StellarSdk.xdr.LedgerKey.contractData(\n    new StellarSdk.xdr.LedgerKeyContractData({\n      contract: new StellarSdk.Address(contractId).toScAddress(),\n      key: key,\n      durability: StellarSdk.xdr.ContractDataDurability.persistent(),\n    })\n  );\n\n  const entries = await rpc.getLedgerEntries(ledgerKey);\n\n  if (entries.entries.length === 0) {\n    return null;\n  }\n\n  return StellarSdk.scValToNative(\n    entries.entries[0].val.contractData().val()\n  );\n}\n```\n\n## Smart Accounts (Passkey Wallets)\n\nFor passwordless authentication using WebAuthn passkeys, use Smart Account Kit.\n\n### Installation\n```bash\nnpm install smart-account-kit\n```\n\n### Quick Start\n```typescript\nimport { SmartAccountKit, IndexedDBStorage } from 'smart-account-kit';\n\nconst kit = new SmartAccountKit({\n  rpcUrl: 'https:\u002F\u002Fsoroban-testnet.stellar.org',\n  networkPassphrase: 'Test SDF Network ; September 2015',\n  accountWasmHash: 'YOUR_ACCOUNT_WASM_HASH',\n  webauthnVerifierAddress: 'CWEBAUTHN_VERIFIER_ADDRESS',\n  storage: new IndexedDBStorage(),\n});\n\n\u002F\u002F On page load - silent restore from stored session\nconst result = await kit.connectWallet();\nif (!result) {\n  showConnectButton(); \u002F\u002F No stored session\n}\n\n\u002F\u002F Create new wallet with passkey\nconst { contractId, credentialId } = await kit.createWallet(\n  'My App',\n  'user@example.com',\n  { autoSubmit: true }\n);\n\n\u002F\u002F Connect to existing wallet (prompts for passkey)\nawait kit.connectWallet({ prompt: true });\n\n\u002F\u002F Sign and submit transactions\nconst result = await kit.signAndSubmit(transaction);\n\n\u002F\u002F Transfer tokens\nawait kit.transfer(tokenContract, recipient, amount);\n```\n\n### Key Features\n- **Session Management**: Automatic credential persistence and silent reconnection\n- **Multiple Signer Types**: Passkeys (secp256r1), Ed25519 keys, policies\n- **Context Rules**: Fine-grained authorization for different operations\n- **Policy Support**: Threshold multisig, spending limits, custom policies\n- **External Wallet Support**: Connect Freighter, LOBSTR via adapters\n- **Gasless Transactions**: Optional relayer integration for fee sponsoring\n\n### Fee Sponsorship with OpenZeppelin Relayer\n\nThe [OpenZeppelin Relayer](https:\u002F\u002Fdocs.openzeppelin.com\u002Frelayer\u002Fstellar) (also called Stellar Channels Service) handles gasless transaction submission. It replaces the deprecated Launchtube service and uses Stellar's native fee bump mechanism so users don't need XLM for fees.\n\n```typescript\nimport * as RPChannels from \"@openzeppelin\u002Frelayer-plugin-channels\";\n\nconst client = new RPChannels.ChannelsClient({\n  baseUrl: \"https:\u002F\u002Fchannels.openzeppelin.com\u002Ftestnet\",\n  apiKey: \"your-api-key\",\n});\n\n\u002F\u002F Submit a smart contract call with fee sponsorship\nconst response = await client.submitSorobanTransaction({\n  func: contractFunc,\n  auth: contractAuth,\n});\n```\n\n- **Testnet hosted instance**: `https:\u002F\u002Fchannels.openzeppelin.com\u002Ftestnet` (API keys at `\u002Fgen`)\n- **Production**: Self-host via Docker ([GitHub](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-relayer))\n- **Stellar docs**: https:\u002F\u002Fdevelopers.stellar.org\u002Fdocs\u002Ftools\u002Fopenzeppelin-relayer\n\n### Resources\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fkalepail\u002Fsmart-account-kit\n- **OpenZeppelin Contracts**: https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fstellar-contracts\n- **Legacy SDK**: https:\u002F\u002Fgithub.com\u002Fkalepail\u002Fpasskey-kit (for simpler use cases)\n\n## Transaction UX Checklist\n\n- [ ] Show loading state during wallet signing\n- [ ] Display transaction hash immediately after submission\n- [ ] Track confirmation status (pending → success\u002Ffailed)\n- [ ] Handle common errors with clear messages:\n  - Wallet not connected\n  - User rejected signing\n  - Insufficient XLM for fees\n  - Account not funded\n  - Network mismatch (wallet on wrong network)\n  - Transaction timeout\u002Fexpired\n- [ ] Prevent double-submission while processing\n- [ ] Show destination and amount before signing\n","# Stellar dApp \u002F Frontend\n\nClient-side development with `@stellar\u002Fstellar-sdk`, wallet connection, signing, and submitting transactions. Covers both classic Stellar operations and smart contract invocation from the browser or Node.js.\n\n## When to use this skill\n- Connecting Freighter or other wallets via Stellar Wallets Kit\n- Building, simulating, signing, and submitting transactions\n- Invoking Stellar smart contracts from a frontend\n- Implementing smart accounts with passkeys\n- Handling network passphrases (Mainnet \u002F Testnet \u002F local)\n\n## Related skills\n- Writing the contract being invoked → `..\u002Fsmart-contracts\u002FSKILL.md`\n- Issuing assets and managing trustlines → `..\u002Fassets\u002FSKILL.md`\n- Querying chain state via RPC \u002F Horizon → `..\u002Fdata\u002FSKILL.md`\n- Building paid APIs or agent payment clients → `..\u002Fagentic-payments\u002FSKILL.md`\n- SEPs the wallet\u002Fanchor flows depend on → `..\u002Fstandards\u002FSKILL.md`\n\n---\n\n\n## Goals\n- Single SDK instance for the app (RPC\u002FHorizon + transaction building)\n- Freighter wallet integration (or multi-wallet via Stellar Wallets Kit)\n- Clean separation of client\u002Fserver in Next.js\n- Transaction sending with proper confirmation handling\n\n## Quick Navigation\n- SDK setup and env config: [SDK Initialization](#sdk-initialization)\n- Wallet integrations: [Wallet Integration](#wallet-integration)\n- Tx build\u002Fsend patterns: [Transaction Building](#transaction-building), [Transaction Submission](#transaction-submission)\n- React + Next.js patterns: [React Components](#react-components), [Next.js App Router Setup](#nextjs-app-router-setup)\n- Smart wallets\u002Fpasskeys: [Smart Accounts (Passkey Wallets)](#smart-accounts-passkey-wallets)\n- Production UX checklist: [Transaction UX Checklist](#transaction-ux-checklist)\n\n## Recommended Dependencies\n\n> **Requires Node.js 20+** - the Stellar SDK dropped Node 18 support.\n\n```bash\nnpm install @stellar\u002Fstellar-sdk @stellar\u002Ffreighter-api\n# Or for multi-wallet support:\nnpm install @stellar\u002Fstellar-sdk @creit.tech\u002Fstellar-wallets-kit\n```\n\n## SDK Initialization\n\n> For the full API reference (RPC methods, Horizon endpoints, migration guide), see [api-rpc-horizon.md](..\u002Fdata\u002FSKILL.md).\n\n### Basic Setup\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\n\n\u002F\u002F For Testnet\nconst testnetServer = new StellarSdk.Horizon.Server(\"https:\u002F\u002Fhorizon-testnet.stellar.org\");\nconst testnetRpc = new StellarSdk.rpc.Server(\"https:\u002F\u002Fsoroban-testnet.stellar.org\");\nconst testnetNetworkPassphrase = StellarSdk.Networks.TESTNET;\n\n\u002F\u002F For Mainnet\nconst mainnetServer = new StellarSdk.Horizon.Server(\"https:\u002F\u002Fhorizon.stellar.org\");\nconst mainnetRpcUrl = process.env.NEXT_PUBLIC_STELLAR_MAINNET_RPC_URL;\nif (!mainnetRpcUrl) throw new Error(\"Missing NEXT_PUBLIC_STELLAR_MAINNET_RPC_URL\");\nconst mainnetRpc = new StellarSdk.rpc.Server(mainnetRpcUrl); \u002F\u002F set from your chosen RPC provider\nconst mainnetNetworkPassphrase = StellarSdk.Networks.PUBLIC;\n```\n\n### Environment Configuration\n> Use a provider-specific mainnet RPC URL (see: https:\u002F\u002Fdevelopers.stellar.org\u002Fdocs\u002Fdata\u002Fapis\u002Frpc\u002Fproviders).\n\n```typescript\n\u002F\u002F lib\u002Fstellar.ts\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\n\nconst NETWORK = process.env.NEXT_PUBLIC_STELLAR_NETWORK || \"testnet\";\n\nconst requireEnv = (name: string): string => {\n  const value = process.env[name];\n  if (!value) throw new Error(`Missing required env var: ${name}`);\n  return value;\n};\n\nexport const config = {\n  testnet: {\n    horizonUrl: \"https:\u002F\u002Fhorizon-testnet.stellar.org\",\n    rpcUrl: \"https:\u002F\u002Fsoroban-testnet.stellar.org\",\n    networkPassphrase: StellarSdk.Networks.TESTNET,\n    friendbotUrl: \"https:\u002F\u002Ffriendbot.stellar.org\",\n  },\n  mainnet: {\n    horizonUrl: \"https:\u002F\u002Fhorizon.stellar.org\",\n    rpcUrl: requireEnv(\"NEXT_PUBLIC_STELLAR_MAINNET_RPC_URL\"),\n    networkPassphrase: StellarSdk.Networks.PUBLIC,\n    friendbotUrl: null,\n  },\n}[NETWORK]!;\n\nexport const horizon = new StellarSdk.Horizon.Server(config.horizonUrl);\nexport const rpc = new StellarSdk.rpc.Server(config.rpcUrl);\n```\n\n## Wallet Integration\n\n### Freighter (Primary Browser Wallet)\n```typescript\n\u002F\u002F hooks\u002FuseFreighter.ts\nimport { useState, useEffect, useCallback } from \"react\";\nimport {\n  isConnected,\n  getAddress,\n  requestAccess,\n  signTransaction,\n  getNetwork,\n} from \"@stellar\u002Ffreighter-api\";\n\nexport function useFreighter() {\n  const [connected, setConnected] = useState(false);\n  const [address, setAddress] = useState\u003Cstring | null>(null);\n  const [network, setNetwork] = useState\u003Cstring | null>(null);\n\n  useEffect(() => {\n    checkConnection();\n  }, []);\n\n  const checkConnection = async () => {\n    const { isConnected: installed, error } = await isConnected();\n    if (error || !installed) return;\n\n    \u002F\u002F getAddress returns address: \"\" until the app has been granted access,\n    \u002F\u002F so a non-empty address means we're already authorized.\n    const { address: addr, error: addressError } = await getAddress();\n    if (addressError || !addr) return;\n\n    const { network: net, error: networkError } = await getNetwork();\n    if (networkError) return;\n    setConnected(true);\n    setAddress(addr);\n    setNetwork(net);\n  };\n\n  const connect = useCallback(async () => {\n    const { isConnected: installed, error } = await isConnected();\n    if (error || !installed) {\n      throw new Error(\"Freighter extension not installed\");\n    }\n\n    \u002F\u002F requestAccess prompts the user and returns the granted address.\n    const { address: addr, error: accessError } = await requestAccess();\n    if (accessError) throw new Error(accessError.message);\n\n    const { network: net, error: networkError } = await getNetwork();\n    if (networkError) throw new Error(networkError.message);\n    setConnected(true);\n    setAddress(addr);\n    setNetwork(net);\n\n    return addr;\n  }, []);\n\n  const disconnect = useCallback(() => {\n    setConnected(false);\n    setAddress(null);\n    setNetwork(null);\n  }, []);\n\n  const sign = useCallback(\n    async (xdr: string, networkPassphrase: string) => {\n      if (!connected) throw new Error(\"Wallet not connected\");\n      const { signedTxXdr, error } = await signTransaction(xdr, {\n        networkPassphrase,\n      });\n      if (error) throw new Error(error.message);\n      return signedTxXdr;\n    },\n    [connected]\n  );\n\n  return { connected, address, network, connect, disconnect, sign };\n}\n```\n\n### Stellar Wallets Kit (Multi-Wallet)\n```typescript\n\u002F\u002F hooks\u002FuseStellarWallet.ts\nimport { useState, useCallback } from \"react\";\nimport {\n  StellarWalletsKit,\n  WalletNetwork,\n  allowAllModules,\n  FREIGHTER_ID,\n  LOBSTR_ID,\n  XBULL_ID,\n} from \"@creit.tech\u002Fstellar-wallets-kit\";\n\nconst kit = new StellarWalletsKit({\n  network: WalletNetwork.TESTNET,\n  selectedWalletId: FREIGHTER_ID,\n  modules: allowAllModules(),\n});\n\nexport function useStellarWallet() {\n  const [address, setAddress] = useState\u003Cstring | null>(null);\n\n  const connect = useCallback(async () => {\n    await kit.openModal({\n      onWalletSelected: async (option) => {\n        kit.setWallet(option.id);\n        const { address } = await kit.getAddress();\n        setAddress(address);\n      },\n    });\n  }, []);\n\n  const disconnect = useCallback(() => {\n    setAddress(null);\n  }, []);\n\n  const sign = useCallback(async (xdr: string) => {\n    const { signedTxXdr } = await kit.signTransaction(xdr);\n    return signedTxXdr;\n  }, []);\n\n  return { address, connect, disconnect, sign, kit };\n}\n```\n\n## Transaction Building\n\n### Basic Payment\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { horizon, config } from \"@\u002Flib\u002Fstellar\";\n\nexport async function buildPaymentTx(\n  sourceAddress: string,\n  destinationAddress: string,\n  amount: string,\n  asset: StellarSdk.Asset = StellarSdk.Asset.native()\n) {\n  const account = await horizon.loadAccount(sourceAddress);\n\n  const transaction = new StellarSdk.TransactionBuilder(account, {\n    fee: StellarSdk.BASE_FEE,\n    networkPassphrase: config.networkPassphrase,\n  })\n    .addOperation(\n      StellarSdk.Operation.payment({\n        destination: destinationAddress,\n        asset: asset,\n        amount: amount,\n      })\n    )\n    .setTimeout(180)\n    .build();\n\n  return transaction.toXDR();\n}\n```\n\n### Smart Contract Invocation\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { rpc, config } from \"@\u002Flib\u002Fstellar\";\n\nexport async function invokeContract(\n  sourceAddress: string,\n  contractId: string,\n  method: string,\n  args: StellarSdk.xdr.ScVal[]\n) {\n  const account = await rpc.getAccount(sourceAddress);\n\n  const contract = new StellarSdk.Contract(contractId);\n\n  let transaction = new StellarSdk.TransactionBuilder(account, {\n    fee: StellarSdk.BASE_FEE,\n    networkPassphrase: config.networkPassphrase,\n  })\n    .addOperation(contract.call(method, ...args))\n    .setTimeout(180)\n    .build();\n\n  \u002F\u002F Simulate to get resource estimates\n  const simulation = await rpc.simulateTransaction(transaction);\n\n  if (StellarSdk.rpc.Api.isSimulationError(simulation)) {\n    throw new Error(`Simulation failed: ${simulation.error}`);\n  }\n\n  \u002F\u002F Assemble with proper resources\n  transaction = StellarSdk.rpc.assembleTransaction(\n    transaction,\n    simulation\n  ).build();\n\n  return transaction.toXDR();\n}\n```\n\n### Building ScVal Arguments\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\n\n\u002F\u002F Common conversions\nconst addressVal = StellarSdk.Address.fromString(address).toScVal();\nconst i128Val = StellarSdk.nativeToScVal(BigInt(amount), { type: \"i128\" });\nconst u32Val = StellarSdk.nativeToScVal(42, { type: \"u32\" });\nconst stringVal = StellarSdk.nativeToScVal(\"hello\", { type: \"string\" });\nconst symbolVal = StellarSdk.nativeToScVal(\"transfer\", { type: \"symbol\" });\n\n\u002F\u002F Struct\nconst structVal = StellarSdk.nativeToScVal(\n  { name: \"Token\", decimals: 7 },\n  {\n    type: {\n      name: [\"symbol\", null],\n      decimals: [\"u32\", null],\n    },\n  }\n);\n\n\u002F\u002F Vec\nconst vecVal = StellarSdk.nativeToScVal([1, 2, 3], { type: \"i128\" });\n```\n\n## Transaction Submission\n\n### Submit and Wait for Confirmation\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { rpc, horizon, config } from \"@\u002Flib\u002Fstellar\";\n\nexport async function submitTransaction(signedXdr: string) {\n  const transaction = StellarSdk.TransactionBuilder.fromXDR(\n    signedXdr,\n    config.networkPassphrase\n  );\n\n  \u002F\u002F For smart contract transactions, use RPC\n  if (transaction.operations.some(op => op.type === \"invokeHostFunction\")) {\n    return submitSorobanTransaction(signedXdr);\n  }\n\n  \u002F\u002F For classic transactions, use Horizon\n  return submitClassicTransaction(signedXdr);\n}\n\nasync function submitSorobanTransaction(signedXdr: string) {\n  const transaction = StellarSdk.TransactionBuilder.fromXDR(\n    signedXdr,\n    config.networkPassphrase\n  ) as StellarSdk.Transaction;\n\n  const response = await rpc.sendTransaction(transaction);\n\n  if (response.status === \"ERROR\") {\n    throw new Error(`Transaction failed: ${response.errorResult}`);\n  }\n\n  \u002F\u002F Poll for completion\n  let getResponse = await rpc.getTransaction(response.hash);\n  while (getResponse.status === \"NOT_FOUND\") {\n    await new Promise((resolve) => setTimeout(resolve, 1000));\n    getResponse = await rpc.getTransaction(response.hash);\n  }\n\n  if (getResponse.status === \"SUCCESS\") {\n    return {\n      hash: response.hash,\n      result: getResponse.returnValue,\n    };\n  }\n\n  throw new Error(`Transaction failed: ${getResponse.status}`);\n}\n\nasync function submitClassicTransaction(signedXdr: string) {\n  const transaction = StellarSdk.TransactionBuilder.fromXDR(\n    signedXdr,\n    config.networkPassphrase\n  ) as StellarSdk.Transaction;\n\n  const response = await horizon.submitTransaction(transaction);\n  return {\n    hash: response.hash,\n    ledger: response.ledger,\n  };\n}\n```\n\n## React Components\n\n### Connect Wallet Button\n```tsx\n\u002F\u002F components\u002FConnectButton.tsx\n\"use client\";\n\nimport { useFreighter } from \"@\u002Fhooks\u002FuseFreighter\";\n\nexport function ConnectButton() {\n  const { connected, address, connect, disconnect } = useFreighter();\n\n  if (connected && address) {\n    return (\n      \u003Cdiv className=\"flex items-center gap-2\">\n        \u003Cspan className=\"text-sm\">\n          {address.slice(0, 4)}...{address.slice(-4)}\n        \u003C\u002Fspan>\n        \u003Cbutton\n          onClick={disconnect}\n          className=\"px-4 py-2 bg-red-500 text-white rounded\"\n        >\n          Disconnect\n        \u003C\u002Fbutton>\n      \u003C\u002Fdiv>\n    );\n  }\n\n  return (\n    \u003Cbutton\n      onClick={connect}\n      className=\"px-4 py-2 bg-blue-500 text-white rounded\"\n    >\n      Connect Wallet\n    \u003C\u002Fbutton>\n  );\n}\n```\n\n### Send Payment Form\n```tsx\n\u002F\u002F components\u002FSendPayment.tsx\n\"use client\";\n\nimport { useState } from \"react\";\nimport { useFreighter } from \"@\u002Fhooks\u002FuseFreighter\";\nimport { buildPaymentTx, submitTransaction } from \"@\u002Flib\u002Ftransactions\";\n\nexport function SendPayment() {\n  const { address, sign } = useFreighter();\n  const [destination, setDestination] = useState(\"\");\n  const [amount, setAmount] = useState(\"\");\n  const [status, setStatus] = useState\u003Cstring | null>(null);\n  const [loading, setLoading] = useState(false);\n\n  const handleSubmit = async (e: React.FormEvent) => {\n    e.preventDefault();\n    if (!address) return;\n\n    setLoading(true);\n    setStatus(\"Building transaction...\");\n\n    try {\n      const xdr = await buildPaymentTx(address, destination, amount);\n\n      setStatus(\"Please sign in your wallet...\");\n      const signedXdr = await sign(xdr, config.networkPassphrase);\n\n      setStatus(\"Submitting transaction...\");\n      const result = await submitTransaction(signedXdr);\n\n      setStatus(`Success! Hash: ${result.hash}`);\n    } catch (error) {\n      setStatus(`Error: ${error.message}`);\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  return (\n    \u003Cform onSubmit={handleSubmit} className=\"space-y-4\">\n      \u003Cinput\n        type=\"text\"\n        placeholder=\"Destination Address\"\n        value={destination}\n        onChange={(e) => setDestination(e.target.value)}\n        className=\"w-full p-2 border rounded\"\n      \u002F>\n      \u003Cinput\n        type=\"text\"\n        placeholder=\"Amount (XLM)\"\n        value={amount}\n        onChange={(e) => setAmount(e.target.value)}\n        className=\"w-full p-2 border rounded\"\n      \u002F>\n      \u003Cbutton\n        type=\"submit\"\n        disabled={loading || !address}\n        className=\"w-full p-2 bg-blue-500 text-white rounded disabled:opacity-50\"\n      >\n        {loading ? \"Processing...\" : \"Send\"}\n      \u003C\u002Fbutton>\n      {status && \u003Cp className=\"text-sm\">{status}\u003C\u002Fp>}\n    \u003C\u002Fform>\n  );\n}\n```\n\n## Next.js App Router Setup\n\n### Provider Component\n```tsx\n\u002F\u002F app\u002Fproviders.tsx\n\"use client\";\n\nimport { ReactNode } from \"react\";\n\n\u002F\u002F Add any context providers here\nexport function Providers({ children }: { children: ReactNode }) {\n  return \u003C>{children}\u003C\u002F>;\n}\n```\n\n### Layout\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { Providers } from \".\u002Fproviders\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003Chtml lang=\"en\">\n      \u003Cbody>\n        \u003CProviders>{children}\u003C\u002FProviders>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  );\n}\n```\n\n## Data Fetching\n\n### Account Balance\n```typescript\nimport { horizon } from \"@\u002Flib\u002Fstellar\";\n\nexport async function getBalance(address: string) {\n  try {\n    const account = await horizon.loadAccount(address);\n    const nativeBalance = account.balances.find(\n      (b) => b.asset_type === \"native\"\n    );\n    return nativeBalance?.balance || \"0\";\n  } catch (error) {\n    if (error.response?.status === 404) {\n      return \"0\"; \u002F\u002F Account not funded\n    }\n    throw error;\n  }\n}\n```\n\n### Contract State\n```typescript\nimport * as StellarSdk from \"@stellar\u002Fstellar-sdk\";\nimport { rpc } from \"@\u002Flib\u002Fstellar\";\n\nexport async function getContractData(\n  contractId: string,\n  key: StellarSdk.xdr.ScVal\n) {\n  const ledgerKey = StellarSdk.xdr.LedgerKey.contractData(\n    new StellarSdk.xdr.LedgerKeyContractData({\n      contract: new StellarSdk.Address(contractId).toScAddress(),\n      key: key,\n      durability: StellarSdk.xdr.ContractDataDurability.persistent(),\n    })\n  );\n\n  const entries = await rpc.getLedgerEntries(ledgerKey);\n\n  if (entries.entries.length === 0) {\n    return null;\n  }\n\n  return StellarSdk.scValToNative(\n    entries.entries[0].val.contractData().val()\n  );\n}\n```\n\n## Smart Accounts (Passkey Wallets)\n\nFor passwordless authentication using WebAuthn passkeys, use Smart Account Kit.\n\n### Installation\n```bash\nnpm install smart-account-kit\n```\n\n### Quick Start\n```typescript\nimport { SmartAccountKit, IndexedDBStorage } from 'smart-account-kit';\n\nconst kit = new SmartAccountKit({\n  rpcUrl: 'https:\u002F\u002Fsoroban-testnet.stellar.org',\n  networkPassphrase: 'Test SDF Network ; September 2015',\n  accountWasmHash: 'YOUR_ACCOUNT_WASM_HASH',\n  webauthnVerifierAddress: 'CWEBAUTHN_VERIFIER_ADDRESS',\n  storage: new IndexedDBStorage(),\n});\n\n\u002F\u002F On page load - silent restore from stored session\nconst result = await kit.connectWallet();\nif (!result) {\n  showConnectButton(); \u002F\u002F No stored session\n}\n\n\u002F\u002F Create new wallet with passkey\nconst { contractId, credentialId } = await kit.createWallet(\n  'My App',\n  'user@example.com',\n  { autoSubmit: true }\n);\n\n\u002F\u002F Connect to existing wallet (prompts for passkey)\nawait kit.connectWallet({ prompt: true });\n\n\u002F\u002F Sign and submit transactions\nconst result = await kit.signAndSubmit(transaction);\n\n\u002F\u002F Transfer tokens\nawait kit.transfer(tokenContract, recipient, amount);\n```\n\n### Key Features\n- **Session Management**: Automatic credential persistence and silent reconnection\n- **Multiple Signer Types**: Passkeys (secp256r1), Ed25519 keys, policies\n- **Context Rules**: Fine-grained authorization for different operations\n- **Policy Support**: Threshold multisig, spending limits, custom policies\n- **External Wallet Support**: Connect Freighter, LOBSTR via adapters\n- **Gasless Transactions**: Optional relayer integration for fee sponsoring\n\n### Fee Sponsorship with OpenZeppelin Relayer\n\nThe [OpenZeppelin Relayer](https:\u002F\u002Fdocs.openzeppelin.com\u002Frelayer\u002Fstellar) (also called Stellar Channels Service) handles gasless transaction submission. It replaces the deprecated Launchtube service and uses Stellar's native fee bump mechanism so users don't need XLM for fees.\n\n```typescript\nimport * as RPChannels from \"@openzeppelin\u002Frelayer-plugin-channels\";\n\nconst client = new RPChannels.ChannelsClient({\n  baseUrl: \"https:\u002F\u002Fchannels.openzeppelin.com\u002Ftestnet\",\n  apiKey: \"your-api-key\",\n});\n\n\u002F\u002F Submit a smart contract call with fee sponsorship\nconst response = await client.submitSorobanTransaction({\n  func: contractFunc,\n  auth: contractAuth,\n});\n```\n\n- **Testnet hosted instance**: `https:\u002F\u002Fchannels.openzeppelin.com\u002Ftestnet` (API keys at `\u002Fgen`)\n- **Production**: Self-host via Docker ([GitHub](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-relayer))\n- **Stellar docs**: https:\u002F\u002Fdevelopers.stellar.org\u002Fdocs\u002Ftools\u002Fopenzeppelin-relayer\n\n### Resources\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fkalepail\u002Fsmart-account-kit\n- **OpenZeppelin Contracts**: https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fstellar-contracts\n- **Legacy SDK**: https:\u002F\u002Fgithub.com\u002Fkalepail\u002Fpasskey-kit (for simpler use cases)\n\n## Transaction UX Checklist\n\n- [ ] Show loading state during wallet signing\n- [ ] Display transaction hash immediately after submission\n- [ ] Track confirmation status (pending → success\u002Ffailed)\n- [ ] Handle common errors with clear messages:\n  - Wallet not connected\n  - User rejected signing\n  - Insufficient XLM for fees\n  - Account not funded\n  - Network mismatch (wallet on wrong network)\n  - Transaction timeout\u002Fexpired\n- [ ] Prevent double-submission while processing\n- [ ] Show destination and amount before signing\n",{"name":5,"description":7,"argument-hint":24,"user-invocable":25},"[dapp task]",true,"main","db2f47e2b79822ad3d8dd0f17489d5d15bcba96d",".claude\u002Fskills\u002Fdapp",3,"https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz","https:\u002F\u002Fwritz.xyz","https:\u002F\u002Fgithub.com\u002FWritzProtocol","https:\u002F\u002Fwritz.xyz\u002F","Native Bitcoin lending on Stellar. No bridge, no custodian.","2026-11-14 18:13:11",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":25},[38,41,44],{"tool":39,"command":40},"npx","npx skills add WritzProtocol\u002Fwritz --skill dapp",{"tool":42,"command":43},"bunx","bunx skills add WritzProtocol\u002Fwritz --skill dapp",{"tool":45,"command":46},"pnpm","pnpm dlx skills add WritzProtocol\u002Fwritz --skill dapp","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fdapp\u002FSKILL.md",[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M77KKJ6DYZP10BJ74CW4H0AE","zk-proofs","Zero-knowledge proofs and privacy patterns on Stellar. Covers Groth16 verification in smart contracts via BLS12-381 host functions (CAP-0059, available), the BN254 + Poseidon proposals (CAP-0074\u002F0075, status-sensitive), and concrete toolchain walkthroughs for Circom (on-chain verifiable today), Noir, and RISC Zero (attestation pattern until BN254 lands). Use when building privacy-preserving applications, ZK-verifier contracts, or wiring a proving toolchain to Stellar.","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fzk-proofs\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M77KKF3SK8JVBGRY4A89HYQC","tyler-architect","System architect and technical design leader. Use when the user asks to talk to Tyler or requests the architect.","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Ftyler-architect\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M77KKCD584VQA1TM1F9Q8JBH","stellar-help","Analyzes current state and user query to answer BMad questions or recommend the next skill(s) to use. Use when user asks for help, bmad help, what to do next, or what to start with in BMad.","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fstellar-help\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M77KK7W2HKQ3QMAG0KJY1BHH","stellar-competitive-landscape","Map the competitive landscape for a Stellar project idea. Use when a user says \"who are my competitors on Stellar\", \"competitive analysis Stellar\", \"what already exists in this space on Stellar\", \"show me similar Stellar projects\", \"is anyone else building this on Stellar\", or \"map the Stellar landscape for X\". Queries the 728-project LumenLoop ecosystem database and Electric Capital developer activity to rank competitors by SCF funding history and repo activity.","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fstellar-competitive-landscape\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M77KK1ACXYN5AZTWR8B5CKTX","standards","Stellar standards, ecosystem, and reference. Covers SEPs (Stellar Ecosystem Proposals), CAPs (Core Advancement Proposals), and a quick map for picking the right standard for wallets, anchors, payments, deposits\u002Fwithdrawals, federation, deep links, and KYC. Also bundles ecosystem references (DeFi protocols, dev tools, wallets, infra, community projects), curated documentation links, and MCP servers (live tools such as Raven). Use when you need to know which SEP applies, or want a starting point for ecosystem integrations, official docs, or live MCP tooling.","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fstandards\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M77KJV8VW46WC58DHJR2296C","smart-contracts","Stellar smart contract development (Rust, soroban-sdk). Entry point with project setup, contract anatomy, and build\u002Fdeploy workflow, routing to three companion files in this directory - development.md (storage\u002FTTL, authorization, cross-contract calls, tokens, events, errors, upgrades, fees, troubleshooting), testing.md (unit, fuzz, property, fork, mutation, integration), and security.md (vulnerability classes, checklists, tooling, audits). Use when writing, testing, reviewing, securing, debugging, or shipping Stellar smart contracts, including anything the user calls \"Soroban\" - Soroban contracts, soroban-sdk, Soroban auth\u002Fstorage\u002FTTL errors, SEP-41 tokens, or SAC integration from contract code.","https:\u002F\u002Fgithub.com\u002FWritzProtocol\u002Fwritz\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002Fsmart-contracts\u002FSKILL.md",[],[]]