[go: nahoru, domu]
Skip to content

Commit

Permalink
Lg/draft 0.6.24 (dfinity#341)
Browse files Browse the repository at this point in the history 
* Wallet info

* DRAFT release notes

* WIP release notes

* Remove host parameter from URL, add more disclaimer to the note about deploy-wallet

* Add a sentence about wallets on the current ic network
  • Loading branch information
@lsgunnlsgunn
lsgunnlsgunn committed Mar 5, 2021
1 parent feb478d commit 0676bb5
Show file tree
Hide file tree
Showing 3 changed files with 59 additions and 18 deletions.
1 change: 1 addition & 0 deletions modules/ROOT/nav.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@
//** link:https://github.com/dfinity/cancan[CanCan]//

.xref:release-notes:sdk-release-notes.adoc[Release notes]
** xref:release-notes:0.6.24-rn.adoc[0.6.24]
** xref:release-notes:0.6.23-rn.adoc[0.6.23]
** xref:release-notes:0.6.22-rn.adoc[0.6.22]
** xref:release-notes:0.6.21-rn.adoc[0.6.21]
Expand Down
3 changes: 1 addition & 2 deletions modules/quickstart/pages/network-quickstart.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,10 @@ Before you download and install this release of the {sdk-short-name}, verify the
+
Currently, the {sdk-short-name} only runs on computers with a macOS or Linux operating system.

////
* You have provided the {company-id} Foundation with a principal associated with your user identity and have received a **wallet canister identifier** in return.
+
A wallet canister with **cycles** is required to deploy and manage applications on the {IC}.
////

* You have `+node.js+` installed if you want to access the default front-end for the default project.

If you aren’t sure how to open a new terminal shell on your local computer or how to install `node.js`, see link:newcomers{outfilesuffix}[Preliminary steps for newcomers].
Expand Down
73 changes: 57 additions & 16 deletions modules/release-notes/pages/0.6.24-rn.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,58 +21,99 @@ The most significant new features and capabilities include updates in the follow

=== DFX

* A new `+deploy-wallet+` subcommand enables you to specify the canister identifier for your cycles wallet WebAssembly module (WASM).
* With this release, you must have a **wallet canister** with **cycles** to deploy or manage applications on the {IC}.
+
For local development, `+dfx+` automatically creates a wallet for you when you run `+dfx canister create+` or `+dfx deploy+` commands within each project.
+
Wallets are also created automatically if you deploy to the {IC} using the `+ic+` network alias before the network is upgraded to require a cycle balance.
+
To deploy and manage applications on the main {IC} network, you must provide the {company-id} Foundation with a principal associated with your user identity and receive a **wallet canister identifier** in return.
+
To deploy applications on the {IC} network:
+
--
. Download and install the {sdk-short-name}.
. Run the `dfx identity get-principal` command to create your default identity and principal:
+
[source,bash]
----
dfx identity get-principal
----
+
Running the command displays output similar to the following:
+
For example, to deploy a cycles wallet for local development, you can run a command similar to the following:
....
dfx identity deploy-wallet <canister-id>
Creating the "default" identity.
- generating new key at /Users/pubs/.config/dfx/identity/default/identity.pem
Created the "default" identity.
wre5u-xietp-k5jz4-sdaaz-g3x4l-zjzxa-lxnly-fp2mk-j3j77-25qat-pqe
....
. Submit the principal to get your wallet canister identifier.
. Run the `+dfx identity set-wallet+` command to associate your wallet canister identifier with your default identity.
+
[source,bash]
----
dfx identity set-wallet <wallet-canister-identifier>
----
. Open the wallet application in a web browser by navigating to the canister with a URL similar to the following:
+
Keep in mind that the wallet canister identifier is specific to an active identity—for example, your `+default+` identity—on a specific network.
....
https://<WALLET-CANISTER-ID>.ic0.app
....
--

* A new command-line option enables you to specify the number of initial cycles to transfer to a newly-created canister.
+
The `+dfx canister create+` and `+dfx deploy+` commands now support a new `+--with-cycles <with-cycles>+` option.
The `+dfx canister create+` and `+dfx deploy+` commands now support a new `+--with-cycles <number-of-cycles>+` option.
This option allows you to specify the initial cycle balance of a canister created by your wallet.
+
You can use this option when running the {IC} network locally or connected to the current `+ic+` network (Sodium) for testing purposes. However, because wallets and cycle balances are not currently used for canisters you create while connected to the current `+ic+` network (Sodium), the `+--with-cycles <with-cycles>+` option does not affect any canister operations.
You can use this option when running the {IC} network locally or connected to the current `+ic+` network (Sodium) for testing purposes. However, because wallets and cycle balances are not currently used for canisters you create while connected to the current `+ic+` network (Sodium), the `+--with-cycles+` option does not affect any canister operations.
+
For example, you might run the following `+dfx canister create+` command to initialize `+8000000000+` cycles for all of the canisters in a project:
+
[source, bash]
----
....
dfx canister create --with-cycles 8000000000 --all
----
....
+
If using `+dfx deploy+`, you might run the following command to initialize `+8000000000+` cycles for the `+backend+` canister in a project:
+
[source, bash]
----
....
dfx deploy --with-cycles 8000000000 backend
----
....
+

NOTE: You must have a cycles wallet canister with a cycles balance on the network where you want to create or deploy additional canisters.
NOTE: You must have a wallet canister with a cycles balance on the network where you want to create or deploy additional canisters.

* You can now use the new `+dfx toolchain+` command to manage the version of the `+dfx+` command-line interface you are using for your projects.
+
The dfx toolchain command enables you to install, uninstall, and set the default version of `dfx` that you want to use.
The `+dfx toolchain+` command enables you to install, uninstall, and set the default version of `dfx` that you want to use.
You can specify the version by the complete version number, the major and minor version number, or a tag name.
For example:

+
....
dfx toolchain install 0.6.24 # complete version
dfx toolchain install 0.6 # major minor version
dfx toolchain install latest # tag name
....

* A new `+deploy-wallet+` subcommand enables you to specify the canister identifier for your cycles wallet WebAssembly module (WASM).
+
For example, if you have an account with a third party exchange provider and receive a wallet canister identifier, you can run a command similar to the following to deploy the wallet and uses its cycles for development:
+
....
dfx identity deploy-wallet <canister-identifier>
....
+
NOTE: The `+deploy-wallet+` feature is intended for a future use case. The command is only applicable if you received the wallet canister identifier as part of a transfer operation that converted ICP tokens to cycles.
In addition, the `+deploy-wallet+` subcommand is **not intended for use** with the current version of {IC} running locally or on the remote network.

=== Candid

* New link:../candid-guide/candid-intro{outfilesuffix}[Candid documentation] for developers provides type mapping information for Rust and JavaScript.

* Candid now supports additional native Rust types and Typescript.

* For additional informatin, see the link:https://github.com/dfinity/candid/blob/master/Changelog.md[Candid changelog].
* For additional information, see the link:https://github.com/dfinity/candid/blob/master/Changelog.md[Candid changelog].

=== Motoko

Expand Down

0 comments on commit 0676bb5

Please sign in to comment.