support StakingAccountActions & StakingAccountQueries in LocalOrchestrationAccount

[0xpatrickdev]

What is the Problem Being Solved?

External CosmosOrchestrationAccount supports the StakingAccountActions and StakingAccountQueries interfaces.

agoric-sdk/packages/orchestration/src/cosmos-api.ts

Lines 144 to 192 in 67275c2

	export interface StakingAccountActions {
	/**
	* Delegate an amount to a validator. The promise settles when the delegation is complete.
	* @param validator - the validator to delegate to
	* @param amount - the amount to delegate
	* @returns void
	*/
	delegate: (
	validator: CosmosValidatorAddress,
	amount: AmountArg,
	) => Promise<void>;
	/**
	* Redelegate from one delegator to another.
	* Settles when the redelegation is established, not 21 days later.
	* @param srcValidator - the current validator for the delegation.
	* @param dstValidator - the validator that will receive the delegation.
	* @param amount - how much to redelegate.
	* @returns
	*/
	redelegate: (
	srcValidator: CosmosValidatorAddress,
	dstValidator: CosmosValidatorAddress,
	amount: AmountArg,
	) => Promise<void>;
	/**
	* Undelegate multiple delegations (concurrently). To delegate independently, pass an array with one item.
	* Resolves when the undelegation is complete and the tokens are no longer bonded. Note it may take weeks.
	* The unbonding time is padded by 10 minutes to account for clock skew.
	* @param delegations - the delegation to undelegate
	*/
	undelegate: (
	delegations: Omit<Delegation, 'delegatorAddress'>[],
	) => Promise<void>;
	/**
	* Withdraw rewards from all validators. The promise settles when the rewards are withdrawn.
	* @returns The total amounts of rewards withdrawn
	*/
	withdrawRewards: () => Promise<DenomAmount[]>;
	/**
	* Withdraw rewards from a specific validator. The promise settles when the rewards are withdrawn.
	* @param validator - the validator to withdraw rewards from
	* @returns
	*/
	withdrawReward: (validator: CosmosValidatorAddress) => Promise<DenomAmount[]>;
	}

1. LocalOrchestrationAccount presents a different interface for delegate and undelegate - it currently takes (string, ertpAmount) instead of (ChainAddress, AmountArg)

2. There is incongruity between undelegate and delegate/redelegate in the StakingActions interface - the former takes an array of delegations while the latter two only accept a single delegation.

3. Some StakingActions have yet to be implemented in LocalOrchestrationAccount.

Unification Tasks

Beta Give feedback

1. LocalOrchestrationAccount .delegate and .undelegate should take ChainAddress and AmountArg as params (currently, (string, ertpAmount)) to match StakingActions
2. CosmosOrchestrationAccount .delegate and .redelegate should take an array of delegations, like .undelegate

Completeness Tasks

Beta Give feedback

1. LocalOrchestrationAccount withdrawReward(validator) is not implemented
2. LocalOrchestrationAccount redelegate is not implemented
3. withdrawRewards() is not implemented on LocalOrchestrationAccount and CosmosOrchestrationAccount
4. The methods of StakingAccountQueries

Description of the Design

Security Considerations

Scaling Considerations

Test Plan

Upgrade Considerations