@@ -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
141180TBD
0 commit comments