Skip to content

Commit 71ac992

Browse files
committed
first pass: moar data
1 parent 58d1ef5 commit 71ac992

1 file changed

Lines changed: 39 additions & 0 deletions

File tree

bip-0329.mediawiki

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,45 @@ The following fragment represents a wallet label export:
136136
{ "type": "tx", "ref": "f546156d9044844e02b181026a1a407abfca62e7ea1159f87bbeaa77b4286c74", "label": "Account #1 Transaction", "origin": "wpkh([d34db33f/84'/0'/1'])" }
137137
</pre>
138138

139+
==Additional Fields==
140+
141+
If the goal is solely to move labels between cooperating wallets,
142+
then above values are the minimum needed. However, wallet data
143+
exports can serve other purposes and many values associated with
144+
addresses, transactions and outputs are already on-hand for the
145+
wallet generating the export, and yet would be hard or impossible
146+
for importing tools to reconstruct.
147+
148+
All of the following values are optional for exporter to provide,
149+
but should be given if they are readily on-hand.
150+
151+
=== Transactions ===
152+
153+
* `height`: an integer giving the block height where this fully-confirmed transaction can be found.
154+
Omit for transactions that are confirmed by less than 6 blocks, or use value zero.
155+
156+
* `time`: ISO-8601 formated timestamp of the block given by height, preferably in UTC.
157+
Example: `2025-01-23T11:40:35-05:00`.
158+
159+
* `fee`: integer giving the number of Satoshis that went to the miner for this transaction.
160+
161+
=== Address, Inputs, and Outputs ===
162+
163+
* `keypath`: the data needed to build full descriptor down to the specific address.
164+
This extends `origin` with the final two components are are unhardened (in the typical case,
165+
assuming BIP-84). Provide string `/1/123` for `wpkh([d34db33f/84'/0'/0'/1/123])`. If
166+
the first character is not `/`, then it should be interpreted as a full descriptior,
167+
independant of `origin` (if any).
168+
169+
=== Inputs, and Outputs ===
170+
171+
* `value`: integer with the number of Satoshis (`nValue`) of the input or output.
172+
173+
=== Address ===
174+
175+
* `heights`: a list of block heights which contain inputs which deposit to the address.
176+
177+
139178
==Reference Implementation==
140179

141180
TBD

0 commit comments

Comments
 (0)