client support for Fast USDC #10735

turadg · 2024-12-18T19:33:31Z

refs: #10677

Description

Everything in #10677 except the offer makers. I think that'll come through Noble integration.

Security Considerations

none

Scaling Considerations

none

Documentation Considerations

none

Testing Considerations

nothing special

Upgrade Considerations

not yet released

cloudflare-workers-and-pages · 2024-12-18T19:37:42Z

Deploying agoric-sdk with Cloudflare Pages

Latest commit:	`f4f6a52`
Status:	✅ Deploy successful!
Preview URL:	https://4fdd78cc.agoric-sdk.pages.dev
Branch Preview URL:	https://10677-fu-client-support.agoric-sdk.pages.dev

View logs

Fixes this warning from typdoc, ``` ./packages/SwingSet/src/controller/controller.js:480:21 - [warning] The relative path ../docs/run-policy.md is not a file and will not be copied to the output directory 480 * [`runPolicy`](../docs/run-policy.md) to rate-limit cleanups. ```

dckc

oops... I think I misinterpreted a request-for-review notification

So these comments might be a bit premature...

dckc · 2025-01-24T23:17:01Z

packages/fast-usdc/src/types.ts

@@ -55,6 +55,11 @@ export interface TransactionRecord extends CopyRecord {
  status: TxStatus;
 }

+export interface ContractRecord extends CopyRecord {


the name... does it refer to "the record you'll get from vstorage if you query the contract's node"?

docstring, please?

dckc · 2025-01-24T23:23:14Z

packages/client-utils/src/types.d.ts

+            : T extends 'agoricNames.instance'
+              ? Array<[string, Instance]>
+              : T extends 'agoricNames.brand'
+                ? Array<[string, Brand]>


A lot of the relevant code expects not just a Brand but a Brand<'nat'> or Brand<'set'>.

agoric-sdk/multichain-testing/test/fast-usdc/fast-usdc.test.ts

Line 168 in b2cb709

const { USDC, FastLP } = await agoricNamesQ(vstorageClient).brands('nat');

agoric-sdk/multichain-testing/test/fast-usdc/fu-actors.ts

Line 39 in b2cb709

const { Invitation } = await agoricNamesQ(vsc).brands('set');

I suppose one can add as Brand<'nat'>, but it almost defeats the point. It's also helpful to reassemble the entries into a record. Do you want to add helpers for this sort of thing?

agreed this is low value because you'll often want the kind of brand. It's still true tho so I think it's worth having here.

dckc · 2025-01-24T23:25:54Z

packages/client-utils/src/types.d.ts

+                : T extends 'fastUsdc'
+                  ? ContractRecord
+                  : T extends 'fastUsdc.poolMetrics'
+                    ? PoolMetrics


It still feels strange for client-utils to depend on fast-usdc. Should it depend on dapp-offer-up and dapp-agoric-basics likewise?

It seems like fast-usdc should extend the type from client-utils.

It is weird but ok for now. We'll have to solve it for #10811

dckc · 2025-01-24T23:26:41Z

packages/fast-usdc/src/cli/lp-commands.js

      /** @type {import('../types.js').PoolMetrics} */
-      // @ts-expect-error it treats this as "unknown"


do you want to get rid of the type annotation while you're at it?

oh yeah thanks

dckc · 2025-01-24T23:28:19Z

packages/fast-usdc/src/exos/advancer.js

+        settlementAddress: ChainAddressShape,
        intermediateRecipient: M.opt(ChainAddressShape),
-        settlementAddress: M.opt(ChainAddressShape),


good catch!

What prompted it, I wonder?

I can't remember but I'm guessing some type feedback

…ests

…s and tests

turadg · 2025-01-25T00:12:21Z

these comments might be a bit premature...

Thanks they're helpful. I was just waiting for CI to get green before requesting.

In the interim I gave Aider with R1+Sonnet a spin. 88f0921 has its solution to adding a ClientSupport module. LGTM! Minor cleanup in f4f6a52.

samsiegart

From description:

Everything in #10677 except the offer makers. I think that'll come through Noble integration.

I think you added the offer makers in packages/fast-usdc/src/clientSupport.js right? Also, by Noble integration do you mean Noble Express UI? Because that won't be submitting any offers AFAIK. Only LPs and OCW will.

I'm assuming we're going to change the CLI and multichain-testing to use these offer functions in a later PR?

The actual code changes in this PR LGTM, so approving.

samsiegart · 2025-01-25T04:39:43Z

packages/fast-usdc/src/clientSupport.js

Do we want to also add functions for accepting the operator invitation and submitting evidence?

samsiegart · 2025-01-25T04:42:16Z

packages/fast-usdc/test/clientSupport.test.js

Test for WithdrawFees?

samsiegart · 2025-01-25T04:50:17Z

packages/builders/scripts/fast-usdc/start-fast-usdc.build.js

@@ -15,7 +15,7 @@ import { parseArgs } from 'node:util';
 /**
 * @import {CoreEvalBuilder, DeployScriptFunction} from '@agoric/deploy-script-support/src/externalTypes.js'
 * @import {ParseArgsConfig} from 'node:util'
- * @import {FastUSDCConfig, FeedPolicy} from '@agoric/fast-usdc/src/types.js'
+ * @import {FastUSDCConfig, FeedPolicy} from '@agoric/fast-usdc';


Nit: there's a semicolon here but not for the lines above. I wonder if eslint/prettier should have a rule for this

dckc

Let's factor the offer makers out of existing code.

And as a result, let's leave BoardRemote behind and go from Number to ERTP ratio early.

dckc · 2025-01-25T05:05:17Z

packages/fast-usdc/src/clientSupport.js

+ * @param {number} opts.amount
+ * @returns {import('@agoric/smart-wallet/src/offers.js').OfferSpec}
+ */
+const makeDepositOffer = ({ brand }, instance, { offerId, amount }) => {


want is required, and the keyword is USDC, not Deposit.

I'd like us to re-use the existing fast usdc deposit type as in:

agoric-sdk/packages/fast-usdc/src/cli/lp-commands.js

Lines 104 to 112 in f0ccde6

/** @type {USDCProposalShapes['deposit']} */

const proposal = {

give: {

USDC: usdcAmount,

},

want: {

PoolShare: fastLPAmount,

},

};

We could calculate the want for them if they pass in metrics or shareWorth as in...

agoric-sdk/packages/fast-usdc/src/cli/lp-commands.js

Lines 101 to 102 in f0ccde6

const metrics = await swk.readPublished('fastUsdc.poolMetrics');

const fastLPAmount = floorDivideBy(usdcAmount, metrics.shareWorth);

We might want a slippage parameter.

dckc · 2025-01-25T05:07:58Z

packages/fast-usdc/src/clientSupport.js

+
+/**
+ * @param {Pick<
+ *   import('@agoric/vats/tools/board-utils.js').AgoricNamesRemotes,


Let's please stop using BoardRemote and hence AgoricNamesRemotes. Just use the ordinary types like Brand.

ref

identity-preserving marshallers for vstorage testing, clients etc. #10491

dckc · 2025-01-25T05:10:57Z

packages/fast-usdc/src/clientSupport.js

+
+// Reusable amount scaling similar to inter-protocol's approach
+const COSMOS_UNIT = 1_000_000n;
+const scaleDecimals = num => BigInt(num * Number(COSMOS_UNIT));


Using Number has weird edge cases. For example, if the product inside BigInt isn't an integer, it throws.

Let's stick to ERTP Amount and Ratio as in:

agoric-sdk/packages/fast-usdc/src/cli/lp-commands.js

Lines 42 to 46 in f0ccde6

const parseUSDCAmount = (amountString, usdc) => {

const USDC_DECIMALS = 6;

const unit = AmountMath.make(usdc, 10n ** BigInt(USDC_DECIMALS));

return multiplyBy(unit, parseRatio(amountString, usdc));

};

parseRatio will take a Number or a string (anything that passes assertParsableNumber), so we could relax amountString likewise.

For commander-style arg parsing, we could export this one:

agoric-sdk/packages/fast-usdc/src/cli/lp-commands.js

Lines 28 to 36 in f0ccde6

const parseDecimal = arg => {

try {

assertParsableNumber(arg);

const n = Number(arg);

return n;

} catch {

throw new InvalidArgumentError('Not a number');

}

};

dckc · 2025-01-25T05:14:14Z

packages/fast-usdc/src/clientSupport.js

+    },
+    proposal: {
+      give: {
+        Deposit: {


Suggested change

Deposit: {

USDC: {

dckc · 2025-01-25T05:15:30Z

packages/fast-usdc/src/clientSupport.js

+ * @param {number} opts.amount
+ * @returns {import('@agoric/smart-wallet/src/offers.js').OfferSpec}
+ */
+const makeWithdrawOffer = ({ brand }, instance, { offerId, amount }) => ({


give is not optional when withdrawing.

again, let's factor this helper out of...

agoric-sdk/packages/fast-usdc/src/cli/lp-commands.js

Lines 134 to 136 in f0ccde6

program

.command('withdraw')

.description("Withdraw USDC from the LP's pool share")

dckc · 2025-01-25T05:16:25Z

packages/fast-usdc/src/clientSupport.js

+});
+
+/** @satisfies {Record<string, import('@agoric/smart-wallet/src/types.js').OfferMaker>} */
+export const Offers = {


Is there any particular reason to export this Offers structure rather than the functions makeDepositOffer and such?

dckc · 2025-01-25T05:41:50Z

packages/fast-usdc/src/clientSupport.js

+ * @param {string} opts.offerId
+ * @returns {import('@agoric/smart-wallet/src/offers.js').OfferSpec}
+ */
+const makeWithdrawFeesOffer = (instance, { offerId }) => ({


This one is much less valuable; only a core-eval can withdraw fees.

But if we want to provide a helper, let's factor it out of...

agoric-sdk/packages/fast-usdc/src/distribute-fees.core.js

Line 32 in f0ccde6

export const distributeFees = async (permittedPowers, config) => {

Note support for both absolute amounts and proportions.

turadg force-pushed the 10677-fu-client-support branch from c76dc1b to e49ad00 Compare December 18, 2024 23:42

turadg force-pushed the 10677-fu-client-support branch from e49ad00 to ea8de31 Compare January 14, 2025 01:16

turadg added 5 commits January 24, 2025 15:12

chore(types): FU ContractRecord

022ef85

chore(types): expand PublishedTypeMap

fa70d39

chore(types): fast-usdc package export types

c19ee68

chore: settlementAddress no longer optional

7374d68

turadg force-pushed the 10677-fu-client-support branch from ea8de31 to 7374d68 Compare January 24, 2025 23:14

turadg requested review from dckc and samsiegart January 24, 2025 23:15

dckc reviewed Jan 24, 2025

View reviewed changes

turadg added 4 commits January 24, 2025 16:10

fixup! chore(types): expand PublishedTypeMap

d08c1ff

fixup! chore(types): FU ContractRecord

fcf6754

feat: add client support module for fast-usdc with offer makers and t…

88f0921

…ests

fixup! feat: add client support module for fast-usdc with offer maker…

f4f6a52

…s and tests

turadg marked this pull request as ready for review January 25, 2025 00:12

turadg requested a review from a team as a code owner January 25, 2025 00:12

samsiegart approved these changes Jan 25, 2025

View reviewed changes

dckc requested changes Jan 25, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

client support for Fast USDC #10735

client support for Fast USDC #10735

turadg commented Dec 18, 2024 •

edited

Loading

cloudflare-workers-and-pages bot commented Dec 18, 2024 •

edited

Loading

dckc left a comment

dckc Jan 24, 2025

dckc Jan 24, 2025

turadg Jan 25, 2025

dckc Jan 24, 2025

turadg Jan 25, 2025

dckc Jan 24, 2025

turadg Jan 25, 2025

dckc Jan 24, 2025

turadg Jan 25, 2025

turadg commented Jan 25, 2025 •

edited

Loading

samsiegart left a comment

samsiegart Jan 25, 2025

samsiegart Jan 25, 2025

samsiegart Jan 25, 2025

dckc left a comment

dckc Jan 25, 2025

dckc Jan 25, 2025

dckc Jan 25, 2025

dckc Jan 25, 2025

dckc Jan 25, 2025

dckc Jan 25, 2025

dckc Jan 25, 2025

		/** @type {import('../types.js').PoolMetrics} */
		// @ts-expect-error it treats this as "unknown"

	/** @type {USDCProposalShapes['deposit']} */
	const proposal = {
	give: {
	USDC: usdcAmount,
	},
	want: {
	PoolShare: fastLPAmount,
	},
	};

	const metrics = await swk.readPublished('fastUsdc.poolMetrics');
	const fastLPAmount = floorDivideBy(usdcAmount, metrics.shareWorth);

	const parseUSDCAmount = (amountString, usdc) => {
	const USDC_DECIMALS = 6;
	const unit = AmountMath.make(usdc, 10n ** BigInt(USDC_DECIMALS));
	return multiplyBy(unit, parseRatio(amountString, usdc));
	};

	const parseDecimal = arg => {
	try {
	assertParsableNumber(arg);
	const n = Number(arg);
	return n;
	} catch {
	throw new InvalidArgumentError('Not a number');
	}
	};

	program
	.command('withdraw')
	.description("Withdraw USDC from the LP's pool share")

client support for Fast USDC #10735

Are you sure you want to change the base?

client support for Fast USDC #10735

Conversation

turadg commented Dec 18, 2024 • edited Loading

Description

Security Considerations

Scaling Considerations

Documentation Considerations

Testing Considerations

Upgrade Considerations

cloudflare-workers-and-pages bot commented Dec 18, 2024 • edited Loading

Deploying agoric-sdk with Cloudflare Pages

dckc left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

turadg commented Jan 25, 2025 • edited Loading

samsiegart left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

dckc left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

turadg commented Dec 18, 2024 •

edited

Loading

cloudflare-workers-and-pages bot commented Dec 18, 2024 •

edited

Loading

turadg commented Jan 25, 2025 •

edited

Loading