@linera/client: integrate signer (#4711)

## Motivation

It's currently difficult to test the `@linera/client` package in
isolation because it always requires a `Signer` instance to use, the
most straightforward one of which is the `PrivateKey` signer that lives
in `@linera/signer`.

## Proposal

Integrate the private-key signer into the `@linera/client` package next
to the `Signer` interface itself as `linera.PrivateKeySigner`.

While we're breaking the API, fix up the package structure of
`@linera/client` a bit (giving us a barrel file as a cleaner place to
inject TypeScript code to live next to the Wasm and its generated shim),
and remove some vestigial functions (`Signer.get_public_key()`, which is
never used any more, and `Client.frontend()`, which made more sense when
this library was intended to be the direct implementation of a Web
extension).

Since the erstwhile `@linera/signer` package now only contains the
MetaMask signer, rename it to `@linera/metamask` and open up its scope
to other MetaMask-specific signers and integrations.

## Test Plan

Automated tests forthcoming :) but I've at least tried it manually with
our counter and native-fungible examples.

## Release Plan

- Nothing to do / These changes follow the usual release cycle.

Breaks SDK API but no need to backport.

## Links

- [reviewer
checklist](https://github.com/linera-io/linera-protocol/blob/main/CONTRIBUTING.md#reviewer-checklist)

Author: Twey

.github/workflows/web.yml

@@ -85,7 +85,7 @@ jobs:
     - name: Test the npm packages
       run: |
         cd web
-        pnpm install
+        pnpm install --frozen-lockfile
         pnpm -r run ci
     - name: Test `linera-views` on the Web
       run: |

examples/counter/index.html

@@ -51,28 +51,27 @@ <h2>Chain history for <code id="chain-id" class="hex">requesting chain…</code>
     <script type="importmap">
       {
           "imports": {
-              "@linera/client": "./js/@linera/client/linera_web.js",
-              "@linera/signer": "./js/@linera/signer/index.js"
+              "@linera/client": "./js/@linera/client/index.js"
           }
       }
     </script>
 
     <script type="module">
       import * as linera from '@linera/client';
-      import { PrivateKey } from '@linera/signer';
       import { ethers } from 'ethers';
 
-      async function run() {
-          await linera.default();
+     async function run() {
+         console.log(linera);
+          await linera.initialize();
           const faucet = await new linera.Faucet(import.meta.env.LINERA_FAUCET_URL);
           const mnemonic = ethers.Wallet.createRandom().mnemonic.phrase;
-          const signer = PrivateKey.fromMnemonic(mnemonic);
+          const signer = linera.PrivateKeySigner.fromMnemonic(mnemonic);
           const wallet = await faucet.createWallet();
           const owner = await signer.address();
           document.getElementById('owner').innerText = owner;
           document.getElementById('chain-id').innerText = await faucet.claimChain(wallet, owner);
           const client = await new linera.Client(wallet, signer);
-          const counter = await client.frontend().application(import.meta.env.LINERA_APPLICATION_ID);
+          const counter = await client.application(import.meta.env.LINERA_APPLICATION_ID);
           const logs = document.getElementById('logs');
           const incrementButton = document.getElementById('increment-btn');
           const blockTemplate = document.getElementById('block-template');

examples/counter/metamask/index.html

@@ -54,26 +54,25 @@ <h2>Chain history for <code id="chain-id" class="hex">requesting chain…</code>
     <script type="importmap">
       {
           "imports": {
-              "@linera/client": "./js/@linera/client/linera_web.js",
-              "@linera/signer": "./js/@linera/signer/index.js"
+              "@linera/client": "./js/@linera/client/dist/index.js"
           }
       }
     </script>
 
     <script type="module">
       import * as linera from '@linera/client';
-      import * as linera_signer from '@linera/signer';
+      import * as linera_metamask from '@linera/metamask';
 
       async function run() {
-          await linera.default();
+          await linera.initialize();
           const faucet = await new linera.Faucet(import.meta.env.LINERA_FAUCET_URL);
-          const signer = await new linera_signer.MetaMask();
+          const signer = await new linera_metamask.Signer();
           const wallet = await faucet.createWallet();
           const owner = await signer.address();
           document.getElementById('owner').innerText = owner;
           document.getElementById('chain-id').innerText = await faucet.claimChain(wallet, owner);
           const client = await new linera.Client(wallet, signer);
-          const counter = await client.frontend().application(import.meta.env.LINERA_APPLICATION_ID);
+          const counter = await client.application(import.meta.env.LINERA_APPLICATION_ID);
           const logs = document.getElementById('logs');
           const incrementButton = document.getElementById('increment-btn');
           const blockTemplate = document.getElementById('block-template');

examples/counter/metamask/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@linera/examples/hosted-counter-metamask",
+  "name": "@linera/examples/metamask",
   "private": true,
   "author": "Linera <[email protected]>",
   "license": "Apache-2.0",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@linera/client": "workspace:*",
-    "@linera/signer": "workspace:*"
+    "@linera/metamask": "workspace:*"
   },
   "devDependencies": {
     "vite": "^5.4.11"

examples/counter/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@linera/examples/hosted-counter",
+  "name": "@linera/examples/counter",
   "private": true,
   "author": "Linera <[email protected]>",
   "license": "Apache-2.0",
@@ -13,10 +13,9 @@
   },
   "dependencies": {
     "@linera/client": "workspace:*",
-    "@linera/signer": "workspace:*",
-    "ethers": "^6.14.3"
+    "ethers": "^6.15.0"
   },
   "devDependencies": {
-    "vite": "^5.4.11"
+    "vite": "^7.1.7"
   }
 }

examples/native-fungible/index.html

@@ -142,15 +142,13 @@ <h2>Chain history for <code id="chain-id" class="hex">requesting a new microchai
     <script type="importmap">
       {
           "imports": {
-              "@linera/client": "./js/@linera/client/linera_web.js",
-              "@linera/signer": "./js/@linera/signer/index.js"
+              "@linera/client": "./js/@linera/client/index.js",
           }
       }
     </script>
 
     <script type="module">
       import * as linera from '@linera/client';
-      import { PrivateKey } from '@linera/signer';
       import { ethers } from 'ethers';
 
       const gql = (query, variables = {}) => JSON.stringify({ query, variables });
@@ -225,18 +223,18 @@ <h2>Chain history for <code id="chain-id" class="hex">requesting a new microchai
               navigator.clipboard.writeText(document.querySelector('#account-id').textContent);
           });
 
-          await linera.default();
+          await linera.initialize();
           const faucet = await new linera.Faucet(import.meta.env.LINERA_FAUCET_URL);
           const mnemonic = ethers.Wallet.createRandom().mnemonic.phrase;
-          const signer = PrivateKey.fromMnemonic(mnemonic);
+          const signer = linera.PrivateKeySigner.fromMnemonic(mnemonic);
           const wallet = await faucet.createWallet();
           const owner = signer.address();
           const chainId = await faucet.claimChain(wallet, owner);
           const client = await new linera.Client(wallet, signer);
           document.querySelector('#chain-id').innerText = chainId;
           document.querySelector('#owner').innerText = owner;
 
-          const application = await client.frontend().application(import.meta.env.LINERA_APPLICATION_ID);
+          const application = await client.application(import.meta.env.LINERA_APPLICATION_ID);
 
           await updateBalance(application, owner);
 

examples/native-fungible/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@linera/examples/hosted-fungible",
+  "name": "@linera/examples/fungible",
   "private": true,
   "author": "Linera <[email protected]>",
   "license": "Apache-2.0",
@@ -13,7 +13,6 @@
   },
   "dependencies": {
     "@linera/client": "workspace:*",
-    "@linera/signer": "workspace:*",
     "ethers": "^6.14.3"
   },
   "devDependencies": {