用途：集成 Circle Onramp 托管组件，让终端用户用法币购买加密货币并交付到指定钱包地址。组件负责 KYC、支付处理与结算，支持多链多代币，可用 assets 字段收窄展示范围。
主要能力：提供两种集成方式，代码几乎相同。App Kit（@circle-fin/app-kit）为一体化套件，onramp 位于 kit.onramp，与 bridge、swap、send、unified balance、earn 并列；Onramp Kit（@circle-fin/onramp-kit）为仅含 onramp 的独立包。两者均发布在公共 npm，安装最新版即可，无需私有源或 .npmrc。
使用方式：分服务端与客户端两半。服务端持有 Circle API 密钥并铸造会话（30 分钟有效，绑定单个用户与目标钱包）；客户端用该会话渲染组件，密钥不进入浏览器。Onramp 不需要钱包适配器。安装命令：npm install @circle-fin/app-kit@latest 或 npm install @circle-fin/onramp-kit@latest，需 Node 22+。API 密钥在 https://console.circle.com/app-kits/onramp 创建，测试网密钥配沙箱（api-test.circle.com + onramp-sandbox.arc.io），主网密钥配生产（api.circle.com + onramp.arc.io），不可混用。渲染可选内联 iframe（mountIframe）或弹窗（openWindow，须在点击处理器内同步调用）。
适用场景：需要在应用中让用户以法币购买加密货币并交付到指定钱包。生产环境启用借记卡、Apple Pay、Google Pay 需完成 KYB（约 48 小时，留意 Transak 邮件），并在服务端 kit 设置 referrerDomain，且须与 KYB 提交域名一致，仅裸主机名。
限制与安全：API 密钥仅存服务端环境变量，禁止硬编码或提交；destinationAddress 必须来自用户明确确认或运行时认证用户提供，不得从仓库推断；会话路由须鉴权并将 appUserId 绑定登录用户；referrerDomain 不得取自请求体或 Origin/Referer 头；浏览器事件仅为 UI 提示，入账须在服务端链上核验，Circle 不发送 onramp webhook。沙箱不强制 referrerDomain，但建议设置以验证接线。