4968 psm econ data

[turadg]

closes: #4968

Description

See curated commit history.

Security Considerations

--

Documentation Considerations

Updated README

Testing Considerations

Added unit tests. To cover startPSM I also tested manually with cosmic-swingset chain,

❯ make scenario2-setup scenario2-run-chain-economy

❯ agd query vstorage keys published.psm.IST.AUSD
children:
- governance
- metrics
pagination: null

❯ agoric follow :published.psm.IST.AUSD.metrics
SES Lockdown using options from environment variables "LOCKDOWN_ERROR_TAMING"
{
  anchorPoolBalance: {
    brand: slot(0,"Alleged: AUSD brand"),
    value: 0n,
  },
  feePoolBalance: {
    brand: slot(1,"Alleged: IST brand"),
    value: 0n,
  },
  totalAnchorProvided: {
    brand: slot(0),
    value: 0n,
  },
  totalStableProvided: {
    brand: slot(1),
    value: 0n,
  },
}

[Chris-Hibbert]

I didn't look closely at the test driver. I'll submit this request while I'm looking that over.

[Chris-Hibbert]

That's all we need to recover the state, but the econ committee will also want to know about flows through the system. We should track the amounts that passed through giveStable and wantStable as well.

[dckc]

@rowgraus @dtribble @btulloh it would be good to get your input on this.

[dtribble]

Everything up to the test file lgtm

[dckc]

Code looks good (by-commit organization reads nicely).

Re design/requirements #4639 doesn't mention the PSM, and #6009 still says "TBD". I wonder if @dtribble was reviewing from that angle. The example output in the PR description is quite handy, meanwhile.

[turadg]

in startPSM the node path is psm.<stable>.<anchor>. There was no no unit test of startPSM and this PR doesn't add one. So the test plan includes manually testing on-chain, which is fuller coverage.

[dckc]

Yeah; that's nice...

It prompted me to wonder about other places where our code might assume the PSM, as if there were only one. For example, E(home.agoricNames).lookup('instance', 'psm').

[dckc]

with input from @btulloh , this seems good to go

requested change performed