Go 接入
Go SDK 适用于后端工具、自建协议服务与需要显式管理签名能力的应用。示例依赖 Go 1.26.1 或更高版本及匹配的 SDK 模块;安装前先核对兼容性与实际可获取的模块 tag。
模块选择
应用通常导入 github.com/invisi-labs/invisi-sdk-go/sdk。primitives、protocol、prover、rpc、session 与 ipp 为按功能分开的模块;需要交互的模块须使用兼容版本。仅解析地址与公开 DTO 时无需启动 prover 或会话。
离线输出示例
下例是完整 Go 程序,只用公开收款材料构造 Note 输出,不执行网络请求。项目需要已配置兼容 SDK 与 go-ethereum 依赖;保存为 main.go 后运行 go run .。演示链与两个合约地址只参与离线计算,不代表真实部署。
package main
import (
"fmt"
"log"
"math/big"
"github.com/ethereum/go-ethereum/common"
"github.com/invisi-labs/invisi-sdk-go/sdk"
)
func main() {
output, err := sdk.NewNoteOutput(sdk.PaymentRequest{
ChainID: big.NewInt(31337),
ProtocolAddress: common.HexToAddress("0x1111111111111111111111111111111111111111"),
TokenAddress: common.HexToAddress("0x2222222222222222222222222222222222222222"),
Amount: big.NewInt(10),
Recipient: sdk.InvisiRecipient{Address: "0i0e0525SFRf53yh2aljmm3sn9JQ5nJk7LqWt0G2ajnRY2pe698y550QXhp9uELXpcCZMf5Y608rRDJ68jJgfEWy5j7U5e5eVNPVz8vW2W2kmyw4p9lVLwW3z3WeFHQs5KdfR980CX"},
})
if err != nil { log.Fatal(err) }
fmt.Println(output.Commitment())
}
big.NewInt(10) 是十个最小单位。Commitment() 的值不证明资金已经入账,随机化也意味着每次运行结果可能不同。
实际支付流程
- 用
sdk.WalletFromAddress构造只含公开收款材料的钱包。 - 注入链 provider、Protocol RPC 和本地 prover,确认目标实例。
- 无状态系统显式选择输入;管理库存时使用
session.Connect与持久化 Store。 - 用
PrepareShield或PrepareTransfer准备操作;需要私密授权时通过ExportWalletAuthorization导出 typed data,由应用签名后WithWalletSignature附加。 - Shield 使用
Ready(ctx)完成准备;需要 ZK 证明的私密操作使用Prove(ctx)后导出 calldata。Credit 撤销走独立 owner 授权路径,不调用证明器。最后由应用的 geth 签名与发送流程提交。 - 保留操作 ID 和交易哈希,核对回执后对账;超时先恢复原操作。
应用实现 DeliveryDecryptor 认证解密回调,只有确认非收款人时返回 nil, nil;锁定、取消及认证失败不能伪装成非收款。完整 Note 查看能力的归集边界同样适用于 Go。
Credit 使用独立状态与操作,不能加入普通 Note 余额。参阅 Credit与会话恢复理解跨语言一致的业务规则。
下载完整离线示例