# Hinkal SDK / API

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/hinkal

私人余额与支付集成工具。本页聚焦SDK查看会话、REST鉴权/缓存及private-send分阶段记录，区分协议、Pay/Wallet/Prime和服务端钱包产品。

官方入口：https://hinkal.io/
类别：稳定币与支付
网络：Ethereum、Arbitrum、Polygon、Base、BNB Chain、Solana、TRON
访问条件：官方文档公开；SDKnullifyingKey会话可查看而不能消费。私人REST读取需active session和x-hinkal-request-signature；可选partner key不替代鉴权，normal session不是view-only。教程不创建或签名会话。
费用：费用随具体操作/链/feeToken变化，REST get-fee需鉴权且schemafeeAmount未注明统一单位；PrivateSend amountIn与amountOut/fee分列，用户发送gas等单独核对。SDK ReceiveVault提及flat settlementgas+.25%只属该接收产品，不套全部调用或宣称免费。

## 用途
- 检查view-only与API会话权限差别
- 核对私有余额链/币/缓存时间
- 解释Private Send订单与逐收款人状态
- 分开准备交易、费用和实际支付

## 使用边界
- SDK/API与Pay、Wallet、Prime、WaaS/MCP角色不同，不能用品牌的non-custodial营销覆盖服务端钱包产品；未核任何真实账户。
- 网络取当前产品/SDK主网表已有规范例子；/supported-chains方法只列curatedEVM，Solana/TRON另有方法支持；旧chainId10示例不证明当前OPMainnet部署。
- 当前TypeScript文档未给安装包固定版本，getTotalBalances/getTotalBalance拼写不同；REST1.0.0、SDKscheduleId/APIorderId及字段名分别保留，未运行SDK或API。
- scheduled订单只表示逐recipient已排队，sent_on_chain是已提交；completed平台状态仍需匹配本人已有链上/收款证据。
- nullifyingKey为敏感账户查看材料，API normal mode会话可授权写入；文档中的筛查/blocked状态只用于记录解释，不绕过风控。
- 旧docs.hinkal.pro读取失败；当前官网与官方GitBook可读，不宣称历史版本退役或当前服务实测可用。

## 操作教程
- [Hinkal 查看余额不一致：区分SDK只读会话、REST权限和缓存](https://lianxiaozhi.com/tools/guides/hinkal-view-session-chain-cache-balance-check)：按本人已有集成记录对照查看权限、chain、token和扫描时刻，分开SDK/REST字段及缓存刷新回执，避免将401或缺字段补成零余额。
- [Hinkal Private Send 显示scheduled却未收到：查逐收款人状态和费用](https://lianxiaozhi.com/tools/guides/hinkal-private-send-scheduled-recipient-fee-check)：将API orderId或SDK scheduleId与存款和逐收款人withdrawal配对，分清排队、提交与确认，核对原amountIn/amountOut和费用而非只看订单顶层状态。

## 相关知识
- [钱包签消息与签交易有什么区别？不付 Gas 的签名也要读内容](https://lianxiaozhi.com/learn/wallet-message-vs-transaction)
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)
- [Gas 怎么计算？交易失败为什么仍可能扣费](https://lianxiaozhi.com/learn/gas-and-failed-transactions)
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [把数据上链，与只保存数据哈希有什么区别？](https://lianxiaozhi.com/learn/data-onchain-vs-offchain)

## 官方依据
- [Hinkal 当前 Products](https://hinkal-team.gitbook.io/hinkal/introduction/platform-components.md)
- [Hinkal TypeScript SDK 查看会话与状态](https://hinkal-team.gitbook.io/hinkal/hinkal-sdk/sdk-description.md)
- [Hinkal API Authentication](https://hinkal-team.gitbook.io/hinkal/hinkal-api/description/authentication.md)
- [Hinkal API Balance OpenAPI](https://hinkal-team.gitbook.io/hinkal/hinkal-api/api-reference/balance.md)
- [Hinkal Get Fee OpenAPI](https://hinkal-team.gitbook.io/hinkal/hinkal-api/api-reference/get-fee.md)
- [Hinkal Get Private Send Order OpenAPI](https://hinkal-team.gitbook.io/hinkal/hinkal-api/api-reference/get-private-send-order.md)
- [Hinkal Supported Chains 方法的产品范围](https://hinkal-team.gitbook.io/hinkal/hinkal-api/api-reference/supported-chains.md)
- [Hinkal API Private Send 两阶段流程](https://hinkal-team.gitbook.io/hinkal/hinkal-api/description/private-send.md)
- [Hinkal Refresh Cache 权限与扫描范围](https://hinkal-team.gitbook.io/hinkal/hinkal-api/api-reference/refresh-cache.md)
- [Hinkal 当前链表与主测试网](https://hinkal-team.gitbook.io/hinkal/ecosystem/supported-chains.md)
- [Hinkal 当前官网与官方文档链接](https://hinkal.io/)