Enum PoolCommand 

pub enum PoolCommand {
    List(PoolListArgs),
    Open(PoolOpenArgs),
    TopUp(PoolTopUpArgs),
    Close(PoolCloseArgs),
    Reclaim(PoolReclaimArgs),
    Assign(PoolAssignArgs),
}

Client-side payment-pool lifecycle operations.

Variants

List(PoolListArgs)

List the tracked buyer pools and their per-lane voucher watermark.

Read-only. The store-backed listings name the store they read — on the store= line, or the store field under --json — and --all names the chain instead, carrying no store field at all.

Four source values, and they do not emit the same --json pool objects, so read source first:

• client_store — the CLI’s own buyer-pools.redb, read directly.
• daemon — a running decdn-node, over the admin RPC, because it holds its buyer.redb exclusively while it runs.
• node_store_offline — a stopped node’s buyer.redb, read off disk: a post-mortem after a crash, or a host down for maintenance.
• chain — --all, which reads no local store to build its list.

The two stores are separate: a client listing says nothing about a node, and vice versa.

Open(PoolOpenArgs)

Open a fresh PaymentPool deposit, escrowing --deposit-micro-usdc USDC (openPool). The pool fans out to every provider paid from it (ADR 003) — there is no per-provider open.

TopUp(PoolTopUpArgs)

Add funds to a pool the caller owns (topUp).

Close(PoolCloseArgs)

Start the grace-window close on a pool the caller owns (closePool). Redemptions stay valid until the dispute deadline; run pool reclaim after it elapses to recover the residual deposit.

Reclaim(PoolReclaimArgs)

Refund the residual deposit of a pool once its grace window has elapsed (reclaim; callable by anyone, but only the owner receives funds).

Assign(PoolAssignArgs)

Issue an owner-signed spending capability delegating a bounded spend on a pool the caller owns to a delegate --signer key, and print the dcap1: token to hand to that delegated client (ADR 003 §Capability delegation). Offline-capable: only the owner keystore is required to sign. An owner check that cannot be performed warns and issues the token anyway. An owner check that reaches the chain and finds a different owner, or no such pool, fails the command, because that token would be rejected at redemption.

Trait Implementations

impl Debug for PoolCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for PoolCommand

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for PoolCommand

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand