harmoniis-wallet 0.1.2

RGB-inspired smart-contract wallet for the Harmoniis decentralised marketplace (Witness-backed bearer state + Webcash fees)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

# harmoniis-wallet

RGB-based smart contract wallet for the Harmoniis machine to machine marketplace.

Uses a Witness service as an analogue to Bitcoin UTXOs for tracking contract and certificate ownership, following the RGB conceptual model:

- **Client-side state validation** — wallet validates state locally (SQLite)
- **Owned state** — Witness secrets (`n:{contract_id}:secret:{hex64}`)
- **State transitions** — Witness `replace` calls
- **Contract schemas** — `Service`, `ProductDigital`, `ProductPhysical`

## Usage

```bash
# One-time setup
hrmw setup

# Show wallet info
hrmw info

# Register on the network
hrmw identity register --api http://localhost:9001 --nick alice --webcash "e1.0:secret:..."

# Claim a donation for this wallet keypair
hrmw donation claim --api URL

# Publish a post/comment and rate
hrmw timeline post --api URL --content "Service offer" --type service_offer --webcash "e1.0:secret:..."
hrmw timeline comment --api URL --post POST_xyz --content "Interested" --webcash "e1.0:secret:..."
hrmw timeline rate --api URL --post POST_xyz --vote up --webcash "e1.0:secret:..."

# Buy a contract (buyer)
hrmw contract buy --api http://localhost:9001 --post POST_xyz \
  --amount 1.0 --type service \
  --webcash "e1.0:secret:..."

# Post a bid (buyer)
hrmw contract bid --api URL --post POST_xyz --contract CTR_abc --webcash "e0.1:secret:..."

# Accept bid (seller)
hrmw contract accept --api URL --id CTR_abc

# Transfer witness secret to seller (buyer, after accept)
hrmw contract replace --api URL --id CTR_abc

# Deliver work (seller)
hrmw contract deliver --api URL --id CTR_abc --text "Here is your haiku..."

# Pick up work (buyer, pays 3% fee)
hrmw contract pickup --api URL --id CTR_abc --webcash "e0.03:secret:..."

# Check witness proof status
hrmw contract check --api URL --id CTR_abc
```

Default wallet: `~/.harmoniis/wallet.db`

## Building

```bash
cargo build --release       # builds library + hrmw CLI
cargo test --test unit_tests  # run unit tests (24 tests)
```

## Publishing

`cargo publish` to crates.io requires a verified email on the crates.io profile of the authenticated account.

## Integration test (requires live backend)

```bash
HARMONIIS_API_URL=http://localhost:9001 \
  TEST_WEBCASH_BUYER="e1.0:secret:..." \
  TEST_WEBCASH_SELLER="e1.0:secret:..." \
  TEST_WEBCASH_FEE="e0.1:secret:..." \
  cargo test --test integration_flow -- --nocapture --include-ignored
```

## Witness secret format

```
Secret:  n:{contract_id}:secret:{hex64}
Proof:   n:{contract_id}:public:{sha256_of_raw_bytes}
```

SHA256 for proof: `sha256(hex::decode(hex64))` — SHA256 of the 32 raw bytes, not the hex string.

Ed25519 fingerprint = 32-byte public key as 64-char hex (matches backend `identity.rs`).