Skip to content Search Apps Documentation Source Content Run Reset Eval Playground File Folder Download Copy Actions State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

dca package

Overview

Package dca is the GnoSwap DCA (dollar-cost averaging) order realm.

Users escrow inputToken and sell amountPerExecution of it for outputToken every interval, executionCount times, at a chosen slot of the interval (e.g. 09:00 UTC daily). Orders of the same pair, interval, and slot form a group that keepers execute in one pool swap per round, on the pair's best whitelisted pool, without the router. Each round's swap output accrues to the orders and is paid by Claim, or by keepers through ClaimGroupOrders; each payout deducts the execution fee at the rate the order snapshotted when it was created.

This package is the permanent entry point. It owns the escrow address, the KV store shared by every version, and the upgrade switch; the business logic lives in a registered implementation (impl/v0).

Files:

  • proxy.gno: state-changing entry points
  • getter.gno: read-only queries
  • store.gno: KV store and store keys
  • state.gno: realm state and the active implementation
  • upgrade.gno: implementation registration and upgrades

Function

SetPairPriceLimit

func SetPairPriceLimit(cur realm, inputToken string, outputToken string, minOutputPerInputX128 string)
Ask AI Claude ChatGPT

SetPairPriceLimit sets the least pool output, before the execution fee, that rounds selling inputToken for outputToken accept per unit of input: minOutputPerInputX128 is raw outputToken units per raw inputToken unit, in Q128 fixed point, as a decimal string. "0" removes the limit.

Every quote and round of the pair direction passes the limit to the pool as its swap price limit, adjusted for the pool's fee tier, so each unit of input fills at a rate of at least the limit and a swap crosses only the ticks up to it. A pool whose price is past the limit is skipped, and a round that cannot be filled within it reverts. A pair direction without a limit cannot be quoted, executed, or receive new orders. The limit applies from the next quote or round, to existing orders too. Its update time is recorded but not checked on-chain.

Admin, governance, or accounts holding the role assigned to the SetPairPriceLimit selector in gno.land/r/gnoswap/order/keeper (PoolManagerRole at deployment).

Params

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/gnoswap/order/dca" -func "SetPairPriceLimit" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "onyx-1" -remote "https://rpc.onyx.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.onyx.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/gnoswap/order/dca" -func "SetPairPriceLimit" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "onyx-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.onyx.testnets.gno.land" call.tx
  

Gno Expression Evaluator

Evaluate any read-only Gno expression against gno.land/r/gnoswap/order/dca, for example a function call with arguments.