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

GetExecutableGroups

func GetExecutableGroups(cursor string, count int) ([]*pdca.Group, error)
Ask AI Claude ChatGPT

GetExecutableGroups returns copies of up to count groups due now, oldest first.

Paging: start with cursor "", then pass pdca.FormatScheduleCursor of the last group back until fewer than count groups return. The cursor is a fixed schedule position, so groups executed between pages do not shift it.

Parameters:

  • cursor: "" or "<nextExecutionTimestamp>|<groupID>" of the last group seen
  • count: maximum number of groups returned

Returns:

  • []*pdca.Group: copies of due groups without their round marks; empty while execution is halted
  • error: non-nil when cursor is malformed

Params

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/gnoswap/order/dca.GetExecutableGroups(,)"

Result

Gno Expression Evaluator

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