Skip to content
This repository was archived by the owner on May 23, 2022. It is now read-only.

chore: add dfx 0.9.1 release notes #674

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@
*** Introducing the SDK
**** xref:developers-guide:install-upgrade-remove.adoc[Install, upgrade, or remove software]
**** xref:release-notes:sdk-release-notes.adoc[Release notes]
***** xref:release-notes:0.9.1-rn.adoc[0.9.1]
***** xref:release-notes:0.9.0-rn.adoc[0.9.0]
***** xref:release-notes:0.8.4-rn.adoc[0.8.4]
***** xref:release-notes:0.8.3-rn.adoc[0.8.3]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -781,9 +781,7 @@ You can use `+raw+` as the argument type if you want to pass raw bytes.

Use the `+dfx canister sign+` command to create a signed `message.json` file using the principal associated with the identity you created using the Privacy Enhanced Mail (PEM) file by running a command similar to the following:

`+dfx canister --no-wallet --network=ic sign --expire-after=1h rno2w-sqaaa-aaaaa-aaacq-cai create_neurons ‘(“PUBLIC_KEY”)’+`

Currently, the `+--no-wallet+` command must be used to execute the command using the user identity instead of the cycles wallet canister identifier.
`+dfx canister --network=ic sign --expire-after=1h rno2w-sqaaa-aaaaa-aaacq-cai create_neurons ‘(“PUBLIC_KEY”)’+`

This command illustrates how to creates a `+message.json+` file to create neurons on the {platform} specified by the `+ic+` alias, that is signed using your principal identifier as the message sender and with an expiration window that ends in one hour.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ For critical applications like those used in DeFI, mutability can be dangerous;
The simplest option is to make the canister immutable by removing its controller. A user can verify the list of controllers for a canister <canister> using dfx. For example:

----
dfx canister --no-wallet --network ic info ryjl3-tyaaa-aaaaa-aaaba-cai
dfx canister --network ic info ryjl3-tyaaa-aaaaa-aaaba-cai
----

will return the list of controllers for the canister with principal `ryjl3-tyaaa-aaaaa-aaaba-cai` (in this example, the ledger canister).
Expand Down
6 changes: 3 additions & 3 deletions modules/developers-guide/pages/default-wallet.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -177,15 +177,15 @@ As an alternative to running the `+dfx wallet add-controller+` command, you can
For example:

....
dfx canister --network ic --no-wallet call f3yw6-7qaaa-aaaab-qaabq-cai add_controller '(principal "vpqee-nujda-46rtu-4noo7-qnxmb-zqs7g-5gvqf-4gy7t-vuprx-u2urx-gqe")'
dfx canister --network ic call f3yw6-7qaaa-aaaab-qaabq-cai add_controller '(principal "vpqee-nujda-46rtu-4noo7-qnxmb-zqs7g-5gvqf-4gy7t-vuprx-u2urx-gqe")'
....

In this example, the principal for the currently-active identity is a controller of the `+f3yw6-7qaaa-aaaab-qaabq-cai+` cycles wallet. The `+--no-wallet+` option enables the call to the `+add_controller+` method to use the principal for the currently-active identity (a controller) and not the cycles wallet (which is not a controller).
In this example, the principal for the currently-active identity is a controller of the `+f3yw6-7qaaa-aaaab-qaabq-cai+` cycles wallet.

To make the cycles wallet a controller of itself, you would run a command similar to the following:

....
dfx canister --network ic --no-wallet call f3yw6-7qaaa-aaaab-qaabq-cai add_controller '(principal "f3yw6-7qaaa-aaaab-qaabq-cai")'
dfx canister --network ic call f3yw6-7qaaa-aaaab-qaabq-cai add_controller '(principal "f3yw6-7qaaa-aaaab-qaabq-cai")'
....
////

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -415,7 +415,7 @@ This command fails because users cannot be assigned the `+owner+` role.
+
[source,bash]
----
dfx --identity bob_standard canister --no-wallet call access_hello greet "Bob"
dfx --identity bob_standard canister call access_hello greet "Bob"
----
+
The command displays output similar to the following:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Then, the easiest way to access this service is using the https://dfinity.org/de
Open your terminal, and run:

----
$ dfx canister --no-wallet --network ic info rdmx6-jaaaa-aaaaa-aaadq-cai
$ dfx canister --network ic info rdmx6-jaaaa-aaaaa-aaadq-cai
Controller: r7inp-6aaaa-aaaaa-aaabq-cai
Module hash: 0xda8d1bdd93fbf1edddeb2a423fa3c528c2e4877d39beed2277a12e60227e44d4
----
Expand Down Expand Up @@ -322,7 +322,7 @@ Summarizing our recommendations for canister authors:

Finally, if your build is reproducible, you can compare the hash of the resulting Wasm code to the hash of the code that is running in a canister, which you retrieve as follows:
----
$ dfx canister --no-wallet --network ic info <canister-id>
$ dfx canister --network ic info <canister-id>
----

Beware that this hash might change if the controllers upgrade the canister code.
4 changes: 2 additions & 2 deletions modules/quickstart/pages/network-quickstart.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -320,10 +320,10 @@ For more information about the Internet Identity service and how to register mul
For example, call the `+authorize+` method for the cycles wallet canister with a command similar to the following:
+
....
dfx canister --no-wallet --network ic call "gastn-uqaaa-aaaae-aaafq-cai" authorize '(principal "ejta3-neil3-qek6c-i7rdw-sxreh-lypfe-v6hjg-6so7x-5ugze-3iohr-2qe")'
dfx canister --network ic call "gastn-uqaaa-aaaae-aaafq-cai" authorize '(principal "ejta3-neil3-qek6c-i7rdw-sxreh-lypfe-v6hjg-6so7x-5ugze-3iohr-2qe")'
....
+
Be sure that the command you copy has the `+--no-wallet+` option and the correct network (`+ic+`) alias.
Be sure that the command you copy has the correct network (`+ic+`) alias.
You should recognize the canister identifier—in this example, `+gastn-uqaaa-aaaae-aaafq-cai+`—as the cycles wallet associated with your identity.
If this is your first wallet on the {platform}, however, you might not recognize the principal being authorized. The use of a different principal is the expected behavior in this case.
+
Expand Down
89 changes: 89 additions & 0 deletions modules/release-notes/pages/0.9.1-rn.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
= Highlights of what's new in {release}
:description: DFINITY Canister Software Development Kit Release Notes
:proglang: Motoko
:IC: Internet Computer
:company-id: DFINITY
:release: 0.9.1
ifdef::env-github,env-browser[:outfilesuffix:.adoc]

An overview of the {release} release:

Be sure to see the link:0.9.1-rn.adoc[0.9.1 Release Notes] and follow the instructions due to breaking changes since dfx 0.8.4.

== Changes to DFX

=== New Feature: Support for local ledger calls

If you have an installation of the ICP Ledger (see https://github.com/dfinity/ic/tree/master/rs/rosetta-api/ledger_canister#deploying-locally[Ledger Installation Guide]), `dfx ledger balance` and `dfx ledger transfer` now support
`--ledger-canister-id` parameter.

Some examples:
```
$ dfx ledger \
--network local \
balance \
--ledger-canister-id rrkah-fqaaa-aaaaa-aaaaq-cai
1000.00000000 ICP

$ dfx ledger \
--network local \
transfer --amount 0.1 --memo 0 \
--ledger-canister-id rrkah-fqaaa-aaaaa-aaaaq-cai 8af54f1fa09faeca18d294e0787346264f9f1d6189ed20ff14f029a160b787e8
Transfer sent at block height: 1
```

=== New Feature: `dfx ledger account-id` can now compute canister addresses

The `dfx ledger account-id` can now compute addresses of principals and canisters.
The command also supports ledger subaccounts now.

[source, bash]
----
dfx ledger account-id --of-principal 53zcu-tiaaa-aaaaa-qaaba-cai
dfx ledger --network small02 account-id --of-canister ledger_demo
dfx ledger account-id --of-principal 53zcu-tiaaa-aaaaa-qaaba-cai --subaccount 0000000000000000000000000000000000000000000000000000000000000001
----

=== New Feature: Print the full error chain in case of a failure

All `dfx` commands will now print the full stack of errors that led to the problem, not just the most recent error.
Example:

[source]
----
Error: Subaccount '00000000000000000000000000000000000000000000000000000000000000000' is not a valid hex string
Caused by:
Odd number of digits
----

=== Fixed: dfx import will now import pem files created by `quill generate`

`quill generate` currently outputs .pem files without an `EC PARAMETERS` section.
`dfx identity import` will now correctly identify these as EC keys, rather than Ed25519.

=== Fixed: retry on failure for ledger create-canister, top-up, transfer

dfx now calls `transfer` rather than `send_dfx`, and sets the created_at_time field in order to retry the following commands:

* dfx ledger create-canister
* dfx ledger top-up
* dfx ledger transfer

== Motoko

Updated Motoko from 0.6.20 to 0.6.21.

== Replica

Updated replica to blessed commit 936bf9ccaabd566c68232e5cb3f3ce7d5ae89328.
This incorporates the following executed proposals:

* https://dashboard.internetcomputer.org/proposal/38541[38541]

== ic-ref

Upgraded from a432156f24faa16d387c9d36815f7ddc5d50e09f to ab8e3f5a04f0f061b8157c2889f8f5de05f952bb

* Support 128-bit system api for cycles
* Include canister_ranges in the state tree
* Removed limit on cycles in a canister