创建您的 Swap 合约

swap contract 允许在两个不同的代币之间进行即时交换。在后台,它使用原子订单在一个或多个现货市场中下达市场订单。

快速开始

任何人都可以实例化交换合约的实例。此合约的一个版本已经上传到 Injective 主网,并可以在此处找到。 在实例化合约之前,作为合约拥有者,你需要回答以下三个问题:

  1. 哪个地址应为手续费接收者? 由于交换合约下的订单是 Injective 交易模块中的订单,这意味着每个订单可以有一个手续费接收者,该接收者可以获得 40% 的交易手续费。通常,交易所 dApp 会将手续费接收者设置为自己的地址。

  2. 该合约应支持哪些代币? 合约中可用的每个代币必须定义一个交易路线。路线是指代币 A 要通过哪些市场才能换取代币 B。例如,如果你想支持 ATOM 和 INJ 之间的交换,则需要通过提供 ATOM/USDT 和 INJ/USDT 的市场 ID 来设置路线,这样它就知道 ATOM 和 INJ 之间的交换路线是 ATOM ⇔ USDT ⇔ INJ。 目前,合约只能支持以 USDT 报价的市场。

  3. 应该为该合约提供多少缓冲资金? 作为合约拥有者,你还需要为合约提供资金,当发生交换时,这些资金将被使用。缓冲资金由合约在下单时使用。如果用户想要交换大额资产或在流动性不足的市场中进行交换,则需要更多的缓冲资金。当合约的缓冲资金无法满足用户输入金额时,会发生错误。

目前,缓冲资金应仅为 USDT。

Messages

Instantiate

初始化合约状态,包含合约版本和配置详情。配置包括管理员地址和手续费接收者地址。

pub fn instantiate(
    deps: DepsMut<InjectiveQueryWrapper>,
    env: Env,
    info: MessageInfo,
    msg: InstantiateMsg,
) -> Result<Response<InjectiveMsgWrapper>, ContractError>

Execute

处理不同类型的交易和管理员功能:

  • SwapMinOutput: 以最小输出数量进行交换。

  • SwapExactOutput: 以精确输出数量进行交换。

  • SetRoute: 设置交换路线。

  • DeleteRoute: 删除交换路线。

  • UpdateConfig: 更新合约配置。

  • WithdrawSupportFunds: 从合约中提取支持资金。

pub fn execute(
    deps: DepsMut<InjectiveQueryWrapper>,
    env: Env,
    info: MessageInfo,
    msg: ExecuteMsg,
) -> Result<Response<InjectiveMsgWrapper>, ContractError>

Reply

处理来自其他合约或交易的回复。

pub fn reply(
    deps: DepsMut<InjectiveQueryWrapper>,
    env: Env,
    msg: Reply,
) -> Result<Response<InjectiveMsgWrapper>, ContractError>

Query

处理对合约的各种查询:

  • GetRoute: 获取特定的交换路径。

  • GetOutputQuantity: 获取给定输入数量的输出数量。

  • GetInputQuantity: 获取给定输出数量的输入数量。

  • GetAllRoutes: 获取所有可用的交换路径。

pub fn query(deps: Deps<InjectiveQueryWrapper>, env: Env, msg: QueryMsg) -> StdResult<Binary>

代码库

swap contract 的完整 GitHub 仓库可以在这里找到。

Last updated