This example shows how to use a Babbage-compatible CIP30 wallet such as Nami to sign Marlowe transactions. The example contract here simply receives a deposit and waits until a specified time before the funds become payable to an address.
This video shows the application in action.
Only three parts of the CIP30 API are used by this example:
- The application connects with
cardano.{walletName}.enable({ extensions: Extension[] } = {}): Promise<API>. - A call to
api.getChangeAddress(): Promise<Address>provides the change address used by Marlowe Runtime. - Calls to
api.signTx(tx: cbor<transaction>, partialSign: bool = false): Promise<cbor<transaction_witness_set>>return a witness to the transaction, which Marlowe Runtime has prepared and later submits.
Marlowe Runtime's POST endpoints for creating transactions will return the unsigned transaction as a result (instead of transaction body) if a particular header is present:
- Contracts endpoint uses "Accept: application/vendor.iog.marlowe-runtime.contract-tx-json" header.
- Transactions endpoint uses "Accept: application/vendor.iog.marlowe-runtime.apply-inputs-tx-json" header.
- Withdraw endpoint uses "Accept: application/vendor.iog.marlowe-runtime.withdraw-tx-json" header.
All the above endpoints also accept witnessset as a payload for PUT request.
- index.html: The HTML page for the application.
- view.css: The CSS styling for the application
- src/controller.js: The JavaScript source code for the application.
- If you have Nix installed, simply execute ./run.sh.
- Alternatively, if you have NodeJS installed, execute
npm installand thennpx webpack-dev-server.
The application is served from http://127.0.0.1:3000. It requires the following:
- Nami wallet is installed in the web browser. (This web application was tested against Nami 3.5.0.)
- Nami is connected to an address with at least 100 ada on the Cardano preproduction network.