From dd8054080d1dd3cd172e3af7bf33288a9d6a61d2 Mon Sep 17 00:00:00 2001 From: Moul <moul@moul.re> Date: Sat, 17 Apr 2021 14:32:02 +0200 Subject: [PATCH] [doc] Add v0.9.0 announcement --- release_notes/v0.9.md | 165 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 165 insertions(+) create mode 100644 release_notes/v0.9.md diff --git a/release_notes/v0.9.md b/release_notes/v0.9.md new file mode 100644 index 00000000..35c19614 --- /dev/null +++ b/release_notes/v0.9.md @@ -0,0 +1,165 @@ +# Silkaj v0.9.0 release + +## Introduction +The Silkaj team is pleased to announce the release of Silkaj 0.9.0. +The most important changes are highlighted in this article, if you are looking for a comprehensive list of changes, check out the [changelog](https://git.duniter.org/clients/python/silkaj/blob/dev/CHANGELOG.md). + +#### Transaction +Silkaj is now properly handling the transaction document size limit. +The 100 lines limit length of the transaction document in the compact format is now properly fulfilled by computing the length of the generated document. + +An important bug has been fixed regarding intermediaries transactions: +When spending lots of sources (i.e. huge amounts from member wallets), many useless intermediaries transactions were sent and displayed. Intermediariers transactions are now correctly handled. + +Unit tests have been written on the `tx` command, which comforts us into developing new features. + +#### Refactored `id`/`lookup` command +The `id` command has been completely refactored. It now offers comprehensive results when looking for an identity by specifying a user identifier or a public key. +Now the non-member user identifier are displayed. +The command now uses same algorithm as `choose_identity()` which relies exclusively on `/wot/lookup` BMA's path. +The command has been renamed to `lookup` to represent more closely what it does. This command renaming will also allow to introduce the future `identity` command. + +```bash +silkaj lookup titi +Public keys or user id found matching 'titi': + +→ 4qJZFRfArLaUMEXDhsd69unsKynEFNLFazAVij4HNsBa:F4z ↔ laetitia97421 +→ 4LCdTC9QsmqbFSHAhyaqGdDCVPr8Ywu2DZ8hDCzkdx4n:8ta ↔ Amandinelaetitia +→ CehfxBHrowP6tXouR73GS52QhGAoNMtabooKbCvT7f3j:6cG ↔ Laetiti974 +→ FtZdA1HzHcDG6utoEgg6R5jjXfEne2ftS2UzvXajKurp:6Sm ↔ Laetitia +→ EUn8uLJxgc3fVXJ1fBA74re4iD4Ws8Nk2xHytX1wLMfK:AQ2 ↔ LaetitiaCarivenc +→ HqHZt9J1U7MwC3RF1bSjPgxACsTypfNjUThYFMZZfK6X:Dk1 ↔ LaetitiaHOFF +→ 5Vcm1zkHKoAMo9yy7Lk2HDX2Yn54agavtEUdrcFNmqkP:8mU ↔ laetitiajanot +→ BfncGdTeq8qvhPZnBaM8T76SHM9xfx78ASRNZtGp64rZ:7tP ↔ titi +→ BWKuSHYojjwzAXZZxSFTf5XVWneUMZqoWGUJEfWaFRL9:21F ↔ titi43 +→ 49nWdTQqDT8qpazzPeP6NH92NwppG7YEh6PFYC2VecNA:Ba6 ↔ titix +``` + +#### New `--full-pubkey` option on the `history` command + +The `history` command adds a new option to display the whole public keys `--full-pubkey`: + +```bash +silkaj -gt history 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH --full-pubkey + +Transactions history from: moul-test 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH:baK +Current balance: 9012407.83 ÄžTest, 161.34 UD ÄžTest on the 2021-04-09 15:16:42 ++---------------------+------------------------------+---------------+-----------------+-----------------------------+ +| Date | Issuers/Recipients | Amounts ÄžTest | Amounts UDÄžTest | Comment | ++=====================+==============================+===============+=================+=============================+ +| 2021-03-29 20:42:33 | | | | Change operation | ++---------------------+------------------------------+---------------+-----------------+-----------------------------+ +| 2021-03-22 20:51:05 | WULdRTxspGdJzrs4vpZsWLGWsu37 | -193320 | -3.460 | | +| | DjqoHyhGDFr5amh:45s | | | | ++---------------------+------------------------------+---------------+-----------------+-----------------------------+ +| 2021-03-22 20:51:05 | WULdRTxspGdJzrs4vpZsWLGWsu37 | -338310 | -6.060 | | +| | DjqoHyhGDFr5amh:45s | | | | ++---------------------+------------------------------+---------------+-----------------+-----------------------------+ +``` + +#### `balance` command is now displaying corresponding member identity user identifier +```bash +silkaj -gt balance 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH +â•’â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•¤â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•• +│ Balance of pubkey │ 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH:baK │ +├──────────────────────────────┼──────────────────────────────────────────────────┤ +│ User identifier │ moul-test │ +├──────────────────────────────┼──────────────────────────────────────────────────┤ +│ Total amount (unit|relative) │ 8634537.83 ÄžTest | 162.21 UD ÄžTest │ +├──────────────────────────────┼──────────────────────────────────────────────────┤ +│ Total relative to M/N │ 1.05 x M/N │ +╘â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•§â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•› +``` + +#### Display option on `cert`, `membership` commands +This general option allows to display the generated document aside of the confirmation prompt before sending the document. +It can be used for debugging, safety, or curiosity purposes. +This option has only been implemented on the `cert` and the `membership` commands for now. +The option should be available in next releases for the three others send-documents commands. + +```bash +silkaj --gtest --auth-file --display cert KapisTest +â•’â•â•â•â•â•â•â•â•â•¤â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•¤â•â•â•â•â•¤â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•• +│ Cert │ Issuer │ –> │ Recipient: Published: #block-hash date │ +├────────┼──────────────────────────────────────────────────┼────┼──────────────────────────────────────────────────┤ +│ ID │ moul-test │ –> │ KapisTest: #673782-00001519… 2020-12-11 11:37:42 │ +├────────┼──────────────────────────────────────────────────┼────┼──────────────────────────────────────────────────┤ +│ Pubkey │ 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH:baK │ –> │ HGuKgbo7s8wjKF8gQwpdPQGG8mLW9vNMq1ZFxMEZgD8c:GZp │ +├────────┼──────────────────────────────────────────────────┼────┼──────────────────────────────────────────────────┤ +│ Valid │ 2021-04-09 │ —> │ 2021-09-02 │ +╘â•â•â•â•â•â•â•â•â•§â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•§â•â•â•â•â•§â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•› +Version: 10 +Type: Certification +Currency: g1-test +Issuer: 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH +IdtyIssuer: HGuKgbo7s8wjKF8gQwpdPQGG8mLW9vNMq1ZFxMEZgD8c +IdtyUniqueID: KapisTest +IdtyTimestamp: 673782-00001519FCBA6DDEFEE65B31ECD145B065F4404F870AAB272419EFA62BF5A677 +IdtySignature: 1KX/Iuv7FuXsxhTwYU/RIO9L0F3I+lGvBLYXRexIoCz35H+yb2Wf3nEXA2XXCPl5aVxcxvreOW2HF43r7ezcDA== +CertTimestamp: 735968-00003F6B07F64573F6FABC510C1CEABEE8358426176BE7F190827A856873C517 + +Do you confirm sending this certification? [y/N]: y +Certification successfully sent. +``` + +```bash +silkaj --gtest --auth-file --display membership +â•’â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•¤â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•• +│ Expiration date of current membership │ in 2 months │ +├────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤ +│ User Identifier (UID) │ moul-test │ +├────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤ +│ Public Key │ 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH:baK │ +├────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤ +│ Block Identity │ 167750-0000A51FF952B76AAA594A46CA0C8156A56988… │ +├────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤ +│ Identity published │ April 20, 2018 │ +├────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤ +│ Expiration date of new membership │ in 2 months │ +├────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤ +│ Expiration date of new membership from the mempool │ in 2 weeks │ +╘â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•§â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•› +Version: 10 +Type: Membership +Currency: g1-test +Issuer: 5B8iMAzq1dNmFe3ZxFTBQkqhq4fsztg1gZvxHXCk1XYH +Block: 735967-00028030F3E2AB38D7EACA997065F58E16F0497EE86BFA23B2DA222EEE80C23C +Membership: IN +UserID: moul-test +CertTS: 167750-0000A51FF952B76AAA594A46CA0C8156A56988D2B2B57BE18ECB4F3CFC25CEC2 +phOKWXHxfPBgkTE+Mui8Fiqb7QSlhPrKalDOzhyUwwLySV/EE2Z/b+vZNfByTn7sFYaHWPck5dsbzJQ6M+fBBA== + +Do you confirm sending this membership document for this identity? [y/N]: y +Membership successfully sent +``` + +#### Dry Run option is becoming a generic option +Before: +```bash +silkaj membership --dry-run +``` + +Now: +```bash +silkaj --dry-run membership +``` + +Note: This option is currently only implemented in the `membership` command. + +Note: The difference between the `--display` and the `--dry-run` options are that the dry run option by-passes the license, and the confirmation approvals. +For safety reasons, the `--dry-run` option doesn't allow, at the end, to send the document on the network. +On contrary, the `--display` option allows to send the document to the network. + +#### Python support +Support for Python 3.5 has been dropped and support for Python 3.9 has been added. + +#### Silkaj v0.8.1 in Debian Bullseye +If you are a user of Debian or its derivatives, you will be able to find Silkaj v0.8.1 available into Debian Bullseye (v11) which is about to be released. +Silkaj package has been updated from v0.6.5 to v0.8.1 and DuniterPy v0.60.1 entered Debian repository for the first time. + +#### Outlook +In the next developments, we are planning to work on DeathReaper, the implementations of the `revoke` and the `identity` commands. +The removal of the asynchronous property, the migration from `tabulate` to `Texttable`, and the migration from BMA to GVA. + +### Thanks +@matograine, @moul, @jonas, @atrax -- GitLab