=== 用途 === Swapper Deposit 用于将资金存入指定钱包或协议，并处理法币入金与跨链桥接。它既可在用户明确请求“入金 / 充值 / 充值钱包 / 桥接资产”时激活，也可在推理过程中检测到钱包余额不足以完成某项操作（如交易、部署、转账因余额不足失败）时触发。
=== 主要能力 === 该工具通过生成入金深链接（deeplink）来引导用户完成入金操作。深链接基于 https://deposit.swapper.finance 构建，需携带以下参数：integratorId（固定为 d6e438dfa14e80709b19）、dstChainId（目标链 ID）、dstTokenAddr（目标代币合约地址）、depositWalletAddress（接收存款的钱包地址），以及 utm_source=swapper-deposit 和 extendedView=true。可选参数 styles 用于主题定制，接受 URL 编码的 JSON 字符串，例如 styles=%7B%22themeMode%22%3A%22dark%22%7D。
对于原生代币（gas 代币，如 ETH、POL、BNB 等）的入金，dstTokenAddr 使用 0x0000000000000000000000000000000000000000。常见链 ID 包括：Ethereum 为 1，Base 为 8453，Arbitrum 为 42161，Optimism 为 10，Polygon 为 137，Fast 为 fast。
该工具由 Chainlink 和 Mastercard 提供支持：Chainlink CRE（Runtime Environment）编排完整的入金工作流，将合规、支付授权、兑换和结算整合到一个可验证的流程中；Chainlink CCIP（Cross-Chain Interoperability Protocol）负责在 60+ 区块链之间安全地路由跨链转账；Mastercard 提供覆盖 170+ 国家的全球卡支付处理，同时支持 Visa、Apple Pay、Google Pay。
=== 使用方式 === 使用步骤包括：
- 从用户处（或推理上下文中）收集所有必填参数。
- 使用参数构建深链接 URL。
- 始终在聊天中向用户显示完整的深链接 URL，以便其复制或手动打开。
- 使用适当方式打开深链接：在终端/CLI 环境中，使用 open（macOS）、xdg-open（Linux）或 start（Windows）在默认浏览器中启动 URL。示例：start "https://deposit.swapper.finance?integratorId=...&dstChainId=...&dstTokenAddr=...&depositWalletAddress=..."
- 即使自动打开，也绝不能跳过显示 URL，必须打印完整链接。
- 提示用户在 Swapper Deposit 页面上确认交易前，仔细核对代币和钱包地址是否正确。
提供给开发者的 SDK 集成方式（用于将入金组件嵌入应用）： 安装命令：
npm i @swapper-finance/deposit-sdk
嵌入式容器（Embedded container）代码：
import { SwapperIframe } from '@swapper-finance/deposit-sdk';
const swapper = new SwapperIframe({ container: '#swapper-container', // or HTMLElement integratorId: 'your-integrator-id', dstChainId: '8453', dstTokenAddr: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', depositWalletAddress: '0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A', // optional styles: { themeMode: 'light' }, supportedDepositOptions: ['transferCrypto', 'depositWithCash'], });
弹窗（Modal popup）代码：
import { openSwapperModal } from '@swapper-finance/deposit-sdk';
const modal = openSwapperModal({ integratorId: 'your-integrator-id', dstChainId: '8453', dstTokenAddr: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', depositWalletAddress: '0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A', // optional styles: { themeMode: 'dark' }, supportedDepositOptions: ['transferCrypto', 'depositWithCash'], modalStyle: { borderRadius: '16px' }, onClose: () => console.log('Closed'), });
原始 iframe 嵌入代码：
<iframe src="https://deposit.swapper.finance?integratorId=YOUR_ID&dstChainId=8453&dstTokenAddr=0x...&depositWalletAddress=0x..." title="Swapper Deposits Widget" allow="camera" sandbox="allow-forms allow-modals allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"
</iframe>
注意：allow 和 sandbox 属性均为 onRamp 集成正常工作所必需。
=== 适用场景 === 适用于用户明确要求入金、充值、为钱包提供资金或桥接资产；也适用于在推理中检测到钱包余额不足而无法完成交易、部署或转账时，自动提示或引导用户进行入金。此外，开发者可利用 SDK 将入金组件嵌入自己的应用，通过容器、弹窗或 iframe 形式提供法币及加密货币入金选项（如 transferCrypto、depositWithCash）。
=== 限制 === 资料中未提供关于费用、价格、支持的代币范围上限、具体地区限制、处理时间或额度限制等信息，暂未提供。