agoric

Agoric CLI

If you just want to use the Agoric CLI for your own smart contract, please see the Getting Started website for information.

Developing Agoric CLI

NOTE: these steps are only for modifying the Agoric CLI. See the above for using it to create your own smart contracts.

If you want to modify the template directory used by Agoric CLI, you can run:

# Change to the template directory
cd template
# Start the http://localhost:8000 Agoric VM
../bin/agoric --sdk start --reset
# Deploy the test contracts
../bin/agoric --sdk deploy contract/deploy.js api/deploy.js

Then, iterate on editing and rerunning the start and deploy steps above to test the new template.

Please create a PR on this repository if you have an improvement for the template.

Changelog

0.4.2 (2020-03-25)

Bug Fixes

• accomodate modified offer ids (38d367d)
• actually synchronise the inbound messages (9568483)
• add missing files and dependencies (2dc3e07)
• allow disabling of logging by setting DEBUG='' (131c1c6)
• allow vats under SwingSet to unwrap their promises (f2be5c7)
• freshen the simple exchange dApp (82f634f), closes #646
• getOfferDescriptions is now working (b50690b)
• hydrateHooks on the HTTP handler instead of addOffer (b3e214d)
• improve command device support (c70b8a1)
• input queuing, and use the block manager for fake-chain (c1282c9)
• introduce and use Store.entries() (b572d51)
• let the caller handle dispatch rejections (8a9761d)
• make default log level for ag-chain-cosmos more compatible (258e4c9)
• make REPL occupy less of screen when below wallet (d4fc392)
• make the changes needed to cancel pending offers (b4caa9e)
• make the fake-chain better (b4e5b02)
• prevent simulated blocks from reentering the kernel (42f7abd), closes #763
• propagate makeContract exceptions (9a3cc18)
• propagate more errors correctly (0437c5f)
• proper sorting of wallet entries (24627eb)
• properly kill off child processes on SIGHUP (93b71cd)
• reenable package.json substitutions (10bece7)
• regression in agoric start --reset (206ecd0)
• reinstate console endowment needed for Zoe contract debugging (851d1ec)
• remove extra interleaved spaces from assert console.error (c6af2e4)
• remove nondeterminism from ag-solo replay (2855b34)
• remove reference to ping (a9a3f0f)
• rename connection to channel (f50a94b)
• revert usage of SIGHUP to SIGINT (2948400)
• secure the console and nestedEvaluate endowments (ed13e80)
• ses-adapter/package.json: fix files (3b77dff)
• silence the builtin modules warning in agoric-cli deploy (9043516)
• we now send 50agstake to each of the validators (9a78552)
• swingset: controller: enforce withSES==true (e4d9b04)
• swingset: disable all non-SES tests (b481008)
• add END_BLOCK controller call (b115b55)
• add issuerRegKey to the purse output (f7d90fa)
• anachrophobia should crash hard (42deaaf), closes #68
• backport scripts/link-cli.js (2974075), closes #661
• display in terms of issuers, not assays (8a2a692)
• don't double-withdraw from the first purse of an assay (b37203e)
• first draft use collection equality (6acbde7)
• fix discrepencies revealed by the agoric-cli test (422b019)
• generalise the wallet to arbitrary offers (4b3ae29)
• make code clearer (efc6b4a)
• panic on END_BLOCK error (28b6d46)
• polish the wallet and dApp UIs (292291f)
• remove 'Nat' from the set that SwingSet provides to kernel/vat code (b4798d9)
• rename .agwallet and .agservers into _agstate (a82d44f)
• run mkdir with recursive option to prevent exceptions (a01fa04), closes #662
• stringify an inboundHandler Error better (6f80429)
• symbols no longer passable (7290a90)
• unbreak the fake-chain (d84ee30)
• use COMMIT_BLOCK action to sync state (5a3c087)
• ag-cosmos-helper: properly register /txs route (17bae2d)
• ag-lcd: tolerate cosmos/cosmos-sdk#5592 (9eee270)
• ag-solo: be more tolerant of missing wallet (94c2a3e)
• ag-solo: don't require a git checkout to init (b8c4474), closes #570 #562
• ag-solo: reenable the ag-solo bundle command (6126774), closes #606
• ag-solo-xs: use noflake to help mitigate CI flakes (4ee9889), closes #471
• agoric-cli: changes to make agoric --sdk basically work again (#459) (1dc046a)
• agoric-cli: install the SDK symlink if requested (f7fd68f)
• ansible: remove state that needs regeneration (110dcb8)
• bundle: use the same HandledPromise (e668d3c), closes #606
• bundle-source: regain default 'getExport' (f234d49)
• chain: properly commit state (7703aa7)
• chain: state is being stored correctly again (fe0b33d)
• cli: improve install, template, fake-chain (0890171)
• configurableGlobals: use to wrap all builtins under SES (53c4549)
• deployment: update deployment steps (7527eb0)
• end-to-end: metering works for some malicious code (905061c)
• evaluator: quiescence works (15adc38)
• github: disable pessimal cache temporarily (4cae336)
• github: hash only minimal cache key files (f79f976), closes actions/runner#319
• github: update build process (d90c1c6)
• go: use agoric-labs/tendermint subscription-keep-id (10b2cd2)
• init: handle symbolic links and ignored files properly (2d6b876)
• lockdown: Begin working toward lockdown-style SES API (3e63758)
• Makefile: better convention for installing ag-chain-cosmos (b27426a)
• Makefile: install ag-chain-cosmos in $GOPATH/bin/ (d4af74f)
• Makefile: set up the GOPATH environment (ab72ca5)
• makePromise: support HandledPromise.unwrap(p) (fb98636)
• metering: bump default combined meter for autoswap compatibility (ac10627)
• metering: get all tests working again (f2a3206)
• metering: more cleanups and documentation (78ced24)
• metering: properly reset for each crank (ba191fe)
• metering: properly transform try/catch/finally (6fd28ae)
• metering: refactor names and implementation (f1410f9)
• provisioner: allow for mount points as well (7350220)
• provisioning-server: remove debug prints (f5b0e14)
• pserver: clarify StackedResource (1251669)
• pserver: new helper arguments and returns (d40f2ac)
• solo: get repl working again (a42cfec)
• spawner: fail-stop meter exhaustion (e390c35)
• spawner: get tests to pass by fighting the esm package (6993c1b)
• spawner: move makeCollect into a separate file (31c2e28)
• start: parse --pull properly (a5ac2c9)
• SwingSet: ensure the registerEndOfCrank doesn't allow sandbox escape (053c56e)
• SwingSet: remove Nat from nested evaluation contexts too (69088d1)
• use latest @agoric/tendermint (346b582)
• SwingSet: remove redundant ${e} ${e.message} (9251375)
• tame-metering: get working under SES 1.0 (8246884)
• tame-metering: new implementation of isConstructor (362456d)
• tame-metering: remove .prototype via bind if necessary (a77c7e3)
• test-make: run the default Makefile target (aa7d960)
• transform-metering: only enable meters; the host has to disable (d1b8e84)
• rename ustake -> uagstake (ac89559)
• try again with tape-xs ag03 (ad24880)
• wrap globals instead of using a Proxy (35b2d5c)
• ag-chain-cosmos: keep SwingSet state in the validator state dir (#434) (00b874c), closes #433
• ansible: double the stakes (21fe284)
• api: remove many unnecessary methods (cf10dc3), closes #41
• bundle: deprecate the experimental E.C() syntax (07f46cc)
• bundle-source: remove "type": "module" from package.json (326b00a), closes #219
• captp: use new @agoric/eventual-send interface (d1201a1)
• cosmic-swingset: minor UI versioning tweaks (e0a5985)
• cosmic-swingset: reduce unnecessary logs (#425) (8dc31a0), closes #424
• cosmic-swingset: reenable setup scripts (e533479), closes #311
• deployment: properly use agoric-sdk tag (75dd0c3)
• deployment: track deployment version (ad63fee)
• deployment: update Dockerfile for Makefile (f5607af)
• docker: cache Go depedency downloads to optimise docker builds (aba22f0)
• docker: more updates for ag-setup-solo (e4b7c86)
• docker: propagate git-revision correctly (d8e6f7e)
• docker: remove dependency on NPM (d3a8050)
• E: address PR comments (a529982)
• eventual-send: Update the API throughout agoric-sdk (97fc1e7)
• fluentd: tweak the Loki records (cf62725)
• fluentd: update cache before running apt (6d44e70)
• fluentd: update Loki store format (a834015)
• HandledPromise: implement specified API (8da7249), closes #42
• Makefile: remove old docker-build and docker-push rules (92a3816)
• package.json: add packages/deployment to workspaces (b847215)
• pserver: use with-blocks when possible (#384) (43ac9ac)
• resolve: protect against reentrancy attack (#401) (d1f25ef), closes #9
• security: update serialize-javascript dependency (#340) (970edd3)
• start: eliminate default fake delay, and add --delay option (28ce729), closes #572
• SwingSet: passing all tests (341718b)
• testnet: properly push agoric/cosmic-swingset-setup (d82aad6)
• timer: don't enforce advancement, just prevent moving backwards (7a0a509), closes #328
• unwrap: pass through non-Thenables before throwing (67aba42), closes #518
• ustake: stake is actually micro-stake (1aaf14f)
• address PR comments (b9ed6b5)
• zoe: have install accept a moduleFormat argument (#235) (8621eca)

Features

• accomodate Zoe roles as is currently designed (d4319d1)
• add anylogger support (4af822d)
• Add legends to the graphs produced by the stat-logger graphing utility (65340d9)
• Add option to force GC after every block, add 'help' command, clean up error reporting (e639ee5)
• Add PDF and stdout support to stat-logger graphing (22238e7)
• add wallet offer publicID querying API to the bridge (4010226)
• add wallet.ping() method for testing (1f07cd2)
• allow subscribing to wallet offer changes (5ad56e6)
• default to silent unles DEBUG=agoric (2cf5cd8)
• implement the Cosmos block manager (3a5936a)
• implement wallet bridge separately from wallet user (41c1278)
• include requestContext in inboundCommand, and use it in wallet (b332870)
• Log (and graph) database disk usage (9f9f5af)
• make ERTP methods acccept promises or payments (4b7f060)
• new multirole (ending with '*') implementation (442fd20)
• polish link-cli a little (ffbd029)
• revamp the wallet for brands and Zoe roles (b4a806c)
• separate registerAPIHandler from registerURLHandler (7c670d9)
• use anylogger (81a8950)
• use anylogger to allow flexible message dispatch (be8abc8)
• ag-solo: integrate wallet UI with REPL (a193e87)
• bigdipper: add Big Dipper config (f98ff43)
• bootstrap: accept explicit semver (such as --bump=1.17.0) (b3da002)
• bundle-source: make getExport evaluate separate modules (bec9c66)
• cosmic-swingset: use a fake chain for scenario3 (#322) (f833610)
• deployment: add Prometheus support for monitoring (713f63a), closes #337
• E: export E.resolve to use HandledPromise.resolve (93c508d)
• eval: end-to-end metered evaluator (db3acfd)
• fluentd: support Loki log store (c4bffbf)
• HandledPromise: add sync unwrap() to get presences (5ec5b78), closes #412
• ibc: use latest cosmos-sdk/ibc-alpha branch (153f1b9)
• init: use --dapp-template (default @agoric/dapp-simple-exchange) (3bdf8ff)
• link-cli: install the Agoric CLI locally (5e38c5a)
• metering: allow the metering vat to register refill functions (ce077a3)
• metering: create a transform to limit resource use (e2c2b68)
• nestedEvaluate: support new moduleFormat (deb8ee7)
• reset-state: add command to ag-solo to reset SwingSet (233c0ff)
• spawner: implement basic metering (8bd495c)
• start: implement agoric start testnet (cbfb306)
• SwingSet: pass all tests with metering installed (d2dbd2c)
• tame-metering: new packages for metering (d421bc5)
• tame-metering: no more Proxy, clean up initialization (467d62b)
• transform: add support for passing RegExp literals through constructor (5c9e1e7)
• transform-eventual-send: pass HandledPromise endowment to evaluator (7a5b74d)
• zoe: implement metering of contracts (9138801)

Performance Improvements

• Remove call to harden in details for performance reasons (de1f04b)