Interact with contracts: upload, instantiate and call commands by ascjones · Pull Request #79 · use-ink/cargo-contract

ascjones · 2020-09-22T16:34:17Z

Adds upload, instantiate and call commands which allows interacting with contracts on live chains with a compatible pallet-contracts.

Upload

cargo contract upload --suri //Alice --dry-run

cargo contract upload --suri //Alice

Instantiate

cargo contract instantiate \
       --constructor new \
       --args false \
       --suri //Alice \
       --code-hash 0xbc1b42256696c8a4187ec3ed79fc602789fc11287c4c30926f5e31ed8169574e \
       --dry-run

cargo contract instantiate \
       --constructor new \
       --args false \
       --suri //Alice \
       --code-hash 0xbc1b42256696c8a4187ec3ed79fc602789fc11287c4c30926f5e31ed8169574e

Instantiate with code

Omitting --code-hash will call instantiate_with_code:

Call

cargo contract call \
       --contract 5FQNUFjuSxjB1o67CneHXieB1Hy6xAj2A4h4dUVLCvNkgRmD \
       --message flip \
       --suri //Alice \
       --dry-run

cargo contract call \
       --contract 5FQNUFjuSxjB1o67CneHXieB1Hy6xAj2A4h4dUVLCvNkgRmD \
       --message flip \
       --suri //Alice

cargo contract call \
       --contract 5FQNUFjuSxjB1o67CneHXieB1Hy6xAj2A4h4dUVLCvNkgRmD \
       --message get \
       --suri //Alice \
       --dry-run

Debug message

If the contract is build in debug mode then

Will result in...

Todo

Display all events resulting from Call
Optional 0x prefix for hex encoded code hash
SS58 AccountIds
Release and use pallet-contracts-primitives and sp-rpc from crates.io
Documentation
- CLI usage help
- extrinsics.md
- transcoding/scon code docs

Follow ups

These will be promoted to their own issue, or into separate issues for following up once this is merged.

Signing: safer alternatives for value bearing chains than providing secret key on the command line. Possibly allow using encrypted file with private key, or integrating with external signers somehow.
Dynamic DispatchError::Module errors, so that error details are displayed correctly across different chains Dynamic DispatchError::Module details paritytech/subxt#443
Gas estimation: auto dry run first to use estimated gas as a value for the gas limit when running actual call.
Add flag --wait-for-finalization. so that success/events are not displayed until the block is finalized
Denominated units for Balances e.g. 100CAN, 1MCAN
Bitvec encoding/decoding
Improve error message when failing to encode contract message arg e40dc80
Set up CI with substrate-contracts-node and unignore integration test: https://github.com/paritytech/cargo-contract/blob/60f65a2863be1266882bdd81861d836baeb06724/src/cmd/extrinsics/integration_tests.rs#L124
Add support for remove_code extrinsic.

src/cmd/extrinsics/call.rs

src/cmd/extrinsics/transcode/encode.rs

ascjones · 2022-02-10T13:40:51Z

Cargo.toml

 parity-wasm = "0.42.2"
 cargo_metadata = "0.14.1"
-codec = { package = "parity-scale-codec", version = "2.3.1", features = ["derive"] }
+scale = { package = "parity-scale-codec", version = "2.3.1", features = ["derive"] }


Renamed because I have an embedded contract for testing purposes and ink! generates code with ::scale imports.

…extrinsics.

Cargo.toml

Co-authored-by: Alexander Theißen <alex.theissen@me.com>

athei

I played around with it a bit and it is working as I imagined it. Some remarks:

Probably fix now

Remove trailing new line from debug message. It looks awkward with the quote on the next line.
Remove the decoding of the module error as long as this is buggy. It is massively confusing to see a wrong error there. Better to not decode.

Fix in follow up

Add support for remove_code extrinsic.

docs/extrinsics.md

Co-authored-by: Alexander Theißen <alex.theissen@me.com>

…target chain differs

ascjones · 2022-02-14T21:49:29Z

* Remove trailing new line from debug message. It looks awkward with the quote on the next line.

Changed this so that it will print successive lines indented:

Other issues addressed and added follow up to list in PR.

cmichi · 2022-02-16T08:34:50Z

Cargo.toml

+async-std = { version = "1.10.0", features = ["attributes", "tokio1"] }
+ink_metadata = { version = "3.0.0-rc8", features = ["derive"] }
+ink_env = "3.0.0-rc8"
+scale-info = { version = "1.0.0", default-features = false, features = ["derive"] }


This will probably trigger a dependabot PR for an upgrade to 2.0.0.

I'll keep it as 1.0.0 for now since that is the same version as ink_metadata rc8 is using.

ascjones mentioned this pull request Sep 22, 2020

Deserialize metadata use-ink/ink#488

Merged

ascjones mentioned this pull request Oct 11, 2020

Use of deprecated methods #84

Closed

cmichi reviewed Oct 16, 2020

View reviewed changes

src/cmd/extrinsics/call.rs Outdated Show resolved Hide resolved

cmichi reviewed Oct 16, 2020

View reviewed changes

src/cmd/extrinsics/transcode/encode.rs Outdated Show resolved Hide resolved

ascjones marked this pull request as ready for review October 26, 2020 10:34

ascjones added 25 commits October 26, 2020 13:46

WIP display all events

c87b62f

Clean up and generalize displaying events

b1dde94

Fix multiple event new lines

ef6a62d

Merge branch 'master' into aj-contract-call

2694631

Fmt

c7ed146

Create wrapper types for Display, derive Debug for originals

3d49c67

Control indentation of pretty printing

0cd6a71

Indent events display

5c6657a

More tuning of runtime events pretty printing

8dfc55a

Fmt

6177275

Use Display impls for printing events

05a2a6a

Add DisplayTransferEvent

f9cf556

Namespace events

b221475

Add CodeStored and Instantiated events

63268ea

Refactor Deploy command and use verbosity for events display

be37527

Fix up string message return

018800d

Code hash LowerHex and println after events

720ed47

Use LowerHex api for Bytes

bce0c92

Parse code hash with 0x prefix

0a7968c

Fmt

4d20da5

Spawn canvas node for integration test

272beec

Increment attempts

44649b9

Get the test running with spawned canvas node

3a68efe

Instantiate deploy works with manual node

abd959d

Test works locally and cleans up temp dir

4ec6409

ascjones added 6 commits February 9, 2022 12:36

+ sign prefix parses to signed int

a1de202

Allow underscores for balance CLI args

e3bf871

Add helper function for handling runtime errors

4756be5

Add helper function for displaying runtime module errors

c126179

Elide lifetime

ae98818

Add some basic module level docs for transcoding

4612d20

ascjones commented Feb 10, 2022

View reviewed changes

ascjones added 7 commits February 10, 2022 15:02

Improve error message where metadata file not found

0083ee6

Adding common args section to extrinsics.md

b398606

Move --dry-run to extrinisic opts and more docs

ca3782e

Move --storage-deposit-limit to ExtrinsicOpts, move ExtrinsicOpts to …

20603c1

…extrinsics.

Add instantiate docs

bda2e8e

Add call docs

703330c

Update Extrinsics docs

0e9ffe7

athei reviewed Feb 14, 2022

View reviewed changes

Cargo.toml Outdated Show resolved Hide resolved

Update Cargo.toml

4351836

Co-authored-by: Alexander Theißen <alex.theissen@me.com>

athei approved these changes Feb 14, 2022

View reviewed changes

docs/extrinsics.md Outdated Show resolved Hide resolved

ascjones and others added 7 commits February 14, 2022 13:59

Don't wait for finalization before displaying transaction success

08b14a0

Update docs/extrinsics.md

9ffc08a

Co-authored-by: Alexander Theißen <alex.theissen@me.com>

Remove static error detail lookup, since it may be inaccurate if the …

760183b

…target chain differs

CLIPPY

09669cd

Print debug message lines

385d91e

Display not Debug return value

1091910

Fmt

9322082

cmichi reviewed Feb 16, 2022

View reviewed changes

cmichi approved these changes Feb 16, 2022

View reviewed changes

ascjones merged commit 4195197 into master Feb 16, 2022

ascjones deleted the aj-contract-call branch February 16, 2022 10:30

ascjones mentioned this pull request Feb 16, 2022

Extrinsics follow ups #432

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Interact with contracts: upload, instantiate and call commands#79

Interact with contracts: upload, instantiate and call commands#79
ascjones merged 366 commits intomasterfrom
aj-contract-call

ascjones commented Sep 22, 2020 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

ascjones Feb 10, 2022

Uh oh!

Uh oh!

athei left a comment •

edited

Loading

Uh oh!

Uh oh!

ascjones commented Feb 14, 2022

Uh oh!

cmichi Feb 16, 2022

Uh oh!

ascjones Feb 16, 2022

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

ascjones commented Sep 22, 2020 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Upload

Instantiate

Instantiate with code

Call

Debug message

Todo

Follow ups

Uh oh!

Uh oh!

Uh oh!

ascjones Feb 10, 2022

Choose a reason for hiding this comment

Uh oh!

Uh oh!

athei left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Probably fix now

Fix in follow up

Uh oh!

Uh oh!

ascjones commented Feb 14, 2022

Uh oh!

cmichi Feb 16, 2022

Choose a reason for hiding this comment

Uh oh!

ascjones Feb 16, 2022

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ascjones commented Sep 22, 2020 •

edited

Loading

athei left a comment •

edited

Loading