Da2ce7:New Transaction

New Transaction is an proposal for a new extendable method of creating transactions.<br /> Each new transaction is defined by a random txnumber that should be unique globally.<br /> Advanced functions, such as transaction scripts, and importing and exporting can appropriately be done using the group of supporting functions.

Contents

Transaction life-cycle

Every New Transaction goes through the following steps. (not always in the same order)

Build

In this stage, a transaction is being built:<br />

  • Any feature of the transaction may be modified.
  • Users can add, remove, any input, output or script.

Ready

In this stage, only certain features may be modified:<br />

  • Only inputs may be changed. (is this correct, or will past signatures be destroyed if we change them?)
  • Any other attribute that doesn’t effect the existing signatures.

Done

In this stage, the transaction is complete, and would be accepted by the network:

  • User still can add inputs, however all the outputs have already been fulfilled, these new inputs will be counted as fees.
  • After any change, a ‘done’ transaction gets automatically demoted to ‘Ready’ state.

Submitted

In this stage the transaction has been published to the bitcoin network and is in/or is awaiting to be included in a block.

Terms

txnumber is a random string given to every transaction for identification purposes.<br /> pubkey is assumed to be owned by the client that preforms the ‘readying’ of the transition (build > ready states)

This entire processing is lazy! Bitcoin will automatically fill-out everything just as it dose at-the-moment with the readytransaction stage.

Please not this draft doesn’t include all possible error responses.

commands:

 /// make a new transaction (6 override)  newtransaction  newtransaction {name}    newtransaction {txuniqueid}  newtransaction {txuniqueid} {name}    newtransaction {txid}  newtransaction {txid} {name}    response {txtxuniqueid} 


 /// add an input to the transaction. (1 overrides)  addinput {txuniqueid} {txid} {index}  addinput {txuniqueid} {txid} {index} {comment}    response {txuniqueid} {iouniqueid} 


 /// add outputs to the transaction (6 overrides)  /// add fee to transaction  addoutput {txuniqueid} {amount} {forced|suggested|optional}  addoutput {txuniqueid} {amount} {forced|suggested|optional} {comment}    // add change address to transaction  addoutput {txuniqueid} {pubkey}  addoutput {txuniqueid} {pubkey} {comment}    // add send outputs  addoutput {txuniqueid} {address} {amount}  addoutput {txuniqueid} {address} {amount} {comment}    response  {txuniqueid} {iouniqueid}    // add many send outputs  addoutputlist {txuniqueid} [{address},{amount}]    response {txuniqueid}  [{iouniqueid}] 


 /// remove input or outpus (1 override)  remove {txuniqueid} {iouniqueid}  remove {txuniqueid} [{iouniqueid}]    response {txuniqueid} droped: {iouniqueid}  response {txuniqueid} droped: [{iouniqueid}] 


 /// prints out human readable information about the tranaction  shownewtransaction {txuniqueid} (1 override)    response {txuniqueid}            in: [{iouniqueid},{address},{amount},(comment)]            in total: {amount}            out: [{iouniqueid},{address},{amount},(comment)]            out total: {amount}            fee: {amount}            size: {readytxn bit}            state: {building:ready:done:submitted}    shownewtransaction {txid} (1 override)    response {txid}            in: [{txid},{address},{amount},(comment)]            in total: {amount}            out: [{address},{amount},(comment)]            out total: {amount}            fee: {amount}            size: {readytxn bit}            block: {block number} 


 /// demote a transaction (1 override)  demotetransaction {txuniqueid}  demotetransaction {txuniqueid} {build|ready|done}    response {txuniqueid} {building|ready|done} 


 /// exports a binary encoded transition (4 override)  exporttransaction {txuniqueid}  exporttransaction [txuniqueid]  exporttransaction {txid}  exporttransaction [txid]    response {binary data} 


 /// import binary encoded transition(s) (1 override)  inporttransaction {binary data}  inporttransaction [{binary data}]    response [{txuniqueid}] 


 /// check and complete build translation (1 override)  reddytransaction {txuniqueid}  reddytransaction [{txuniqueid}]    response [{txuniqueid}] {has made changes|no changes needed|not enough coins|invalid transaction} 


 /// sign ready transaction (6 override)  signtransaction {txuniqueid}  signtransaction [{txuniqueid}]    // calls reddytransaction before hand if needed  signtransaction -r {txuniqueid}  signtransaction -r [{txuniqueid}]    // sign a pre-signed/partial transaction (signs for owned private keys)  signtransaction -o {txuniqueid}  signtransaction -o [{txuniqueid}]    response [{txuniqueid},{done|failed}] 


 /// publish a done transaction to peers (2 override)  // submits all 'done'  transactions  submittransaction -a    // submits a single  'done'  transaction  submittransaction {txuniqueid}    //  submits a list of 'done'  transaction  submittransaction [{txuniqueid}]    response [{txuniqueid},{txid}] 


 /// complete transaction from any stage and publish it (1 override)  completeransaction {txuniqueid}    response {txuniqueid} {txid} 


 /// delete a transaction from local client  droptransaction {txuniqueid}    responce dropped: {txuniqueid}

Source

http://bitcoin.it/

See Also on BitcoinWiki