实物兑换接入指南

金库地区与批次

从选择卡牌到下单

1. 验证收货地址。 调用验证配送地址时，在请求体顶层传入 countryCode、addressLine1、city 和 postalCode。按需填写 addressLine2 和 state，并根据响应中的 status 和 detail 确认地址。
2. 获取运费报价。 调用查询运费，传入选定的 tokenIds，将收货地址放在 address 对象中。保存 quoteId 和 expiresAt。向用户展示快递选项、保险和报价中的 handlingFeeInUsd。若费用减免，该值可为零。地址表单的国家及地区列表由应用提供。
3. 准备结账。 调用准备结账，传入 quoteId、courierId、recipient 和 insurance。保存 preparationId。请用户确认卡牌、收件人、地址和总额，另行列出预估关税及税款。

核对签名内容

• 将钱包、链、卡牌 ID、收件人、地址、快递及 totalFeeInUsdt 与用户确认的订单对照。
• 确认代币及合约可信、授权未过期、钱包余额及授权额度充足。如需向 Permit2 授权 USDT，先等待交易确认。
• 核对 permitTypedData 中的 witness 与 redemptionTypedData 中兑换批次的哈希，再请钱包签署许可。如有变化，先返回确认页。

import {
  getError, getValue, isFailed,
  type PreparedRedemption, type RedemptionClient, type RedemptionExpectation,
} from '@renaiss-protocol/client';

export async function signReviewedCheckout(
  shipping: RedemptionClient,
  prepared: PreparedRedemption,
  reviewed: RedemptionExpectation,
) {
  const result = await shipping.signRedemption({ prepared, expected: reviewed });
  if (isFailed(result)) throw new Error(getError(result).detail);
  return getValue(result);
}

过期与恢复

订单与物流