Bitcoin Computer
Search…
Api
This Api describes the class Computer that can create and synchronize to smart objects, the class DB that can read, write, and update data on the blockchain, and the class Wallet, a Bitcoin wallet
Computer
The constructor of the Computer class takes one argument as shown below.
1
const computer = new Computer({
2
seed, // a bip39 mnemonic
3
chain, // 'BSV' or 'BCH'
4
network, // 'livenet' or 'testnet'
5
wocApiKey, // a woc api key (optional)
6
path = "m/44'/0'/0'/0", // a bip 32 path
7
})
Copied!
The constructor returns an object
computer that contains a sub-object computer.db of class Dband a sub-object computer.db.wallet of class Wallet. In this section we explain the functions of the Computer class and we explain the Db and Wallet class in the following sections. computer.new
The
new() method creates new smart objects. It has two parameters, a class and a list of arguments. The arguments can be basic data types or smart objects.1
class A {
2
constructor(n) {
3
this.n = n
4
}
5
}
6
​
7
const a1 = await computer.new(A, [1])
Copied!
We encode an output as a string of the form <transaction-id>:<output-number>. We refer to an output encoded in this form as a location.
The
new() method returns a smart object generated from the class and the arguments. It broadcasts a transaction that records the creation of the smart object. The smart object has the methods and properties defined in the class, and four extra properties:_id: the location where the object is deployed. The id remains fixed throughout the lifecycle of the object._rev: the location where the object is currently stored. Initially_idand_revare identical. When a method of the smart object is called its new state is stored at a new location which is stored in the_revproperty._owners: an array containing string encoded public keys. A function can only be called on a smart object if it was created by a computer instance that contains a private key corresponding to a public keys in the list of owners._amount: a number encoding the number of satoshis stored in the smart object.
The properties
_idand _revare read-only but the properties _ownersand _amount can be assigned in constructor and function calls.computer.sync
The
sync() method returns the smart object stored at a given revision.1
const revision = a1._rev
2
const a2 = await computer.sync(revision)
Copied!
After running the code above
a1 and a2 will be distinct objects with identical values.computer.getRevs [NEW]
The
getRevs() method returns an array containing the latest revisions owned by a given public key. The public keys are string encoded. If no parameter is passed to getRevs() the public key of the computer object is used.1
const publicKey = '03223d34686d6f19d20519156a030f7216e5d5bd6daa9442572bbaa446d06c8dfe'
2
const revs = await computer.getRevs(publicKey)
Copied!
computer.getLatestRev [NEW]
The
getLatestRev() method inputs an id and returns the latest revision of the smart object with that id. If no smart object with that id exists an error is thrown.1
const id = a1._id
2
const rev = await computer.getLatestRev(id)
Copied!
After running the above code
rev will be equal to a._rev if a1 is a smart object.Db
The recommended way to create an instance of the
Db class is to create an object of the Computer class and to access its property computer.db.1
const computer = new Computer({ seed, chain, network })
2
const { db } = computer
Copied!
db.put
The
put() method inputs an array of JSON objects and stores them in a transaction. Each element of the array is stored in a separate output. The method returns the array of locations of the outputs created.1
const data = [{a: 1}, {b: { c: 2 }}]
2
const locs = await computer.db.put(data)
3
// locs === ['0322...8dfe:0', '0322...8dfe:1']
Copied!
db.get
The
get() method returns the JSON objects stored at a given array of locations.1
const locs = await computer.db.put(data)
2
const fromChain = await computer.db.get(locs)
3
// fromChain === data
Copied!
db.update
The
update() method has two parameters: a list of locations and a list of JSON objects. It broadcasts a transaction that spends the locations and that has one output for each JSON object. The output script of each output is the concatenation of a multisig script and a OP_PUSH that adds the JSON followed by OP_DROP.1
const locs1 = await computer.db.put([{ n: 1 }])
2
const locs2 = await computer.db.update(locs, [{ n: 2 }])
3
const fromChain = await computer.db.get(locs2)
4
// fromChain === [{n: 2}]
Copied!
You can use
db.get() to inspect the smart contract protocol. Try to call db.get()with the ids or rev of a smart object to see the data on the blockchain. Remember to pass the id inside an array likedb.get([a._id]).Wallet
We recommend creating a
Wallet instance by creating a Computer instance and accessing the nested wallet property.1
const { db } = new Computer({ seed, chain, network })
2
const { wallet } = db
Copied!
The wallet built into Bitcoin Computer is compatible with the widely used Bitcore library. This makes it easy to integrate Bitcoin Computer into existing apps.
wallet.getMenmonic
The
getMnemonic() method returns a Bitcore compatible Javascript object encoding a Mnemonic. To return the mnemonic string call the toString() method.1
const mnemonic = wallet.getMnemonic()
2
const mnemonicString = mnemonic.toString()
Copied!
wallet.getPublicKey
The
getPublicKey() method returns a Bitcore compatible Javascript object encoding a public key. To return the public key in string encoding call the toString() method.1
const publicKey = wallet.getPublicKey()
2
const publicKeyString = publicKey.toString()
Copied!
wallet.getAddress
The
getPublicKey() method returns a Bitcore compatible Javascript object encoding a Bitcoin address. To return the address in string encoding call the toString() method.1
const address = wallet.getAddress()
2
const addressString = address.toString()
Copied!
wallet.getBalance
The
getBalance() method returns the current balance in satoshi.1
const balance = await wallet.getBalance()
Copied!
wallet.send
The
send() method sends an amount of satoshi to an address.1
const amount = 100000 // in satoshi
2
Const address = '1FFsHfDBEh57BB1nkeuKAk25H44U7mmMXd'
3
const balance = await wallet.send(amount, address)
Copied!
Last modified 1yr ago