Permalink
1138 lines (900 sloc) 35.9 KB

Siad API

Sia uses semantic versioning and is backwards compatible to version v1.0.0.

API calls return either JSON or no content. Success is indicated by 2xx HTTP status codes, while errors are indicated by 4xx and 5xx HTTP status codes. If an endpoint does not specify its expected status code refer to #standard-responses.

There may be functional API calls which are not documented. These are not guaranteed to be supported beyond the current release, and should not be used in production.

Notes:

  • Requests must set their User-Agent string to contain the substring "Sia-Agent".
  • By default, siad listens on "localhost:9980". This can be changed using the --api-addr flag when running siad.
  • Do not bind or expose the API to a non-loopback address unless you are aware of the possible dangers.

Example GET curl call:

curl -A "Sia-Agent" "localhost:9980/wallet/transactions?startheight=1&endheight=250"

Example POST curl call:

curl -A "Sia-Agent" --data "amount=123&destination=abcd" "localhost:9980/wallet/siacoins"

Standard responses

Success

The standard response indicating the request was successfully processed is HTTP status code 204 No Content. If the request was successfully processed and the server responded with JSON the HTTP status code is 200 OK. Specific endpoints may specify other 2xx status codes on success.

Error

The standard error response indicating the request failed for any reason, is a 4xx or 5xx HTTP status code with an error JSON object describing the error.

{
    "message": String

    // There may be additional fields depending on the specific error.
}

Authentication

API authentication can be enabled with the --authenticate-api siad flag. Authentication is HTTP Basic Authentication as described in RFC 2617, however, the username is the empty string. The flag does not enforce authentication on all API endpoints. Only endpoints that expose sensitive information or modify state require authentication.

For example, if the API password is "foobar" the request header should include

Authorization: Basic OmZvb2Jhcg==

Units

Unless otherwise specified, all parameters should be specified in their smallest possible unit. For example, size should always be specified in bytes and Siacoins should be specified in hastings. JSON values returned by the API will also use the smallest possible unit, unless otherwise specified.

If a numbers is returned as a string in JSON, it should be treated as an arbitrary-precision number (bignum), and it should be parsed with your language's corresponding bignum library. Currency values are the most common example where this is necessary.

Table of contents

Daemon

Route HTTP verb
/daemon/constants GET
/daemon/stop GET
/daemon/version GET

For examples and detailed descriptions of request and response parameters, refer to Daemon.md.

/daemon/constants [GET]

returns the set of constants in use.

JSON Response (with comments)
{
  "genesistimestamp":      1257894000, // Unix time
  "blocksizelimit":        2000000,    // bytes
  "blockfrequency":        600,        // seconds per block
  "targetwindow":          1000,       // blocks
  "mediantimestampwindow": 11,         // blocks
  "futurethreshold":       10800,      // seconds
  "siafundcount":          "10000",
  "siafundportion":        "39/1000",
  "maturitydelay":         144,        // blocks

  "initialcoinbase": 300000, // Siacoins (see note in Daemon.md)
  "minimumcoinbase": 30000,  // Siacoins (see note in Daemon.md)

  "roottarget": [0,0,0,0,32,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
  "rootdepth":  [255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255],

  "maxadjustmentup":   "5/2",
  "maxadjustmentdown": "2/5",

  "siacoinprecision": "1000000000000000000000000" // hastings per siacoin
}

/daemon/stop [GET]

cleanly shuts down the daemon. May take a few seconds.

Response

standard success or error response. See #standard-responses.

/daemon/version [GET]

returns the version of the Sia daemon currently running.

JSON Response (with comments)
{
  "version": "1.0.0"
}

Consensus

Route HTTP verb
/consensus GET

For examples and detailed descriptions of request and response parameters, refer to Consensus.md.

/consensus [GET]

returns information about the consensus set, such as the current block height.

JSON Response (with comments)
{
  "synced":       true,
  "height":       62248,
  "currentblock": "00000000000008a84884ba827bdc868a17ba9c14011de33ff763bd95779a9cf1",
  "target":       [0,0,0,0,0,0,11,48,125,79,116,89,136,74,42,27,5,14,10,31,23,53,226,238,202,219,5,204,38,32,59,165]
}

Gateway

Route HTTP verb
/gateway GET
/gateway/connect/:netaddress POST
/gateway/disconnect/:netaddress POST

For examples and detailed descriptions of request and response parameters, refer to Gateway.md.

/gateway [GET] (example)

returns information about the gateway, including the list of connected peers.

JSON Response (with comments)
{
    "netaddress": String,
    "peers":      []{
        "netaddress": String,
        "version":    String,
        "inbound":    Boolean
    }
}

/gateway/connect/:netaddress [POST] (example)

connects the gateway to a peer. The peer is added to the node list if it is not already present. The node list is the list of all nodes the gateway knows about, but is not necessarily connected to.

Path Parameters (with comments)
:netaddress
Response

standard success or error response. See #standard-responses.

/gateway/disconnect/:netaddress [POST] (example)

disconnects the gateway from a peer. The peer remains in the node list.

Path Parameters (with comments)
:netaddress
Response

standard success or error response. See #standard-responses.

Host

Route HTTP verb
/host GET
/host POST
/host/announce POST
/host/storage GET
/host/storage/folders/add POST
/host/storage/folders/remove POST
/host/storage/folders/resize POST
/host/storage/sectors/delete/:merkleroot POST

For examples and detailed descriptions of request and response parameters, refer to Host.md.

/host [GET]

fetches status information about the host.

JSON Response (with comments)
{
  "externalsettings": {
    "acceptingcontracts":   true,
    "maxdownloadbatchsize": 17825792, // bytes
    "maxduration":          25920,    // blocks
    "maxrevisebatchsize":   17825792, // bytes
    "netaddress":           "123.456.789.0:9982",
    "remainingstorage":     35000000000, // bytes
    "sectorsize":           4194304,     // bytes
    "totalstorage":         35000000000, // bytes
    "unlockhash":           "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789ab",
    "windowsize":           144, // blocks

    "collateral":    "57870370370",                     // hastings / byte / block
    "maxcollateral": "100000000000000000000000000000",  // hastings

    "contractprice":          "30000000000000000000000000", // hastings
    "downloadbandwidthprice": "250000000000000",            // hastings / byte
    "storageprice":           "231481481481",               // hastings / byte / block
    "uploadbandwidthprice":   "100000000000000",            // hastings / byte

    "revisionnumber": 0,
    "version":        "1.0.0"
  },

  "financialmetrics": {
    "contractcount":                 2,
    "contractcompensation":          "123", // hastings
    "potentialcontractcompensation": "123", // hastings

    "lockedstoragecollateral": "123", // hastings
    "lostrevenue":             "123", // hastings
    "loststoragecollateral":   "123", // hastings
    "potentialstoragerevenue": "123", // hastings
    "riskedstoragecollateral": "123", // hastings
    "storagerevenue":          "123", // hastings
    "transactionfeeexpenses":  "123", // hastings

    "downloadbandwidthrevenue":          "123", // hastings
    "potentialdownloadbandwidthrevenue": "123", // hastings
    "potentialuploadbandwidthrevenue":   "123", // hastings
    "uploadbandwidthrevenue":            "123"  // hastings
  },

  "internalsettings": {
    "acceptingcontracts":   true,
    "maxdownloadbatchsize": 17825792, // bytes
    "maxduration":          25920,    // blocks
    "maxrevisebatchsize":   17825792, // bytes
    "netaddress":           "123.456.789.0:9982",
    "windowsize":           144, // blocks

    "collateral":       "57870370370",                     // hastings / byte / block
    "collateralbudget": "2000000000000000000000000000000", // hastings
    "maxcollateral":    "100000000000000000000000000000",  // hastings

    "mincontractprice":          "30000000000000000000000000", // hastings
    "mindownloadbandwidthprice": "250000000000000",            // hastings / byte
    "minstorageprice":           "231481481481",               // hastings / byte / block
    "minuploadbandwidthprice":   "100000000000000"             // hastings / byte
  },

  "networkmetrics": {
    "downloadcalls":     0,
    "errorcalls":        1,
    "formcontractcalls": 2,
    "renewcalls":        3,
    "revisecalls":       4,
    "settingscalls":     5,
    "unrecognizedcalls": 6
  }
}

/host [POST]

configures hosting parameters. All parameters are optional; unspecified parameters will be left unchanged.

Query String Parameters (with comments)
acceptingcontracts   // Optional, true / false
maxdownloadbatchsize // Optional, bytes
maxduration          // Optional, blocks
maxrevisebatchsize   // Optional, bytes
netaddress           // Optional
windowsize           // Optional, blocks

collateral       // Optional, hastings / byte / block
collateralbudget // Optional, hastings
maxcollateral    // Optional, hastings

mincontractprice          // Optional, hastings
mindownloadbandwidthprice // Optional, hastings / byte
minstorageprice           // Optional, hastings / byte / block
minuploadbandwidthprice   // Optional, hastings / byte
Response

standard success or error response. See #standard-responses.

/host/announce [POST]

Announces the host to the network as a source of storage. Generally only needs to be called once.

Query String Parameters (with comments)
netaddress string // Optional
Response

standard success or error response. See #standard-responses.

/host/storage [GET]

gets a list of folders tracked by the host's storage manager.

JSON Response (with comments)
{
  "folders": [
    {
      "path":              "/home/foo/bar",
      "capacity":          50000000000,     // bytes
      "capacityremaining": 100000,          // bytes

      "failedreads":      0,
      "failedwrites":     1,
      "successfulreads":  2,
      "successfulwrites": 3
    }
  ]
}

/host/storage/folders/add [POST]

adds a storage folder to the manager. The manager may not check that there is enough space available on-disk to support as much storage as requested

Query String Parameters (with comments)
path // Required
size // bytes, Required
Response

standard success or error response. See #standard-responses.

/host/storage/folders/remove [POST]

remove a storage folder from the manager. All storage on the folder will be moved to other storage folders, meaning that no data will be lost. If the manager is unable to save data, an error will be returned and the operation will be stopped.

Query String Parameters (with comments)
path  // Required
force // bool, Optional, default is false
Response

standard success or error response. See #standard-responses.

/host/storage/folders/resize [POST]

grows or shrink a storage folder in the manager. The manager may not check that there is enough space on-disk to support growing the storage folder, but should gracefully handle running out of space unexpectedly. When shrinking a storage folder, any data in the folder that needs to be moved will be placed into other storage folders, meaning that no data will be lost. If the manager is unable to migrate the data, an error will be returned and the operation will be stopped.

Query String Parameters (with comments)
path    // Required
newsize // bytes, Required
Response

standard success or error response. See #standard-responses.

/host/storage/sectors/delete/:merkleroot [POST]

deletes a sector, meaning that the manager will be unable to upload that sector and be unable to provide a storage proof on that sector. This endpoint is for removing the data entirely, and will remove instances of the sector appearing at all heights. The primary purpose is to comply with legal requests to remove data.

Path Parameters (with comments)
:merkleroot
Response

standard success or error response. See #standard-responses.

Host DB

Request HTTP Verb
/hostdb/active GET
/hostdb/all GET

For examples and detailed descriptions of request and response parameters, refer to HostDB.md.

/hostdb/active [GET] (example)

lists all of the active hosts known to the renter, sorted by preference.

Query String Parameters (with comments)
numhosts // Optional
JSON Response (with comments)
{
  "hosts": [
    {
      "acceptingcontracts":   true,
      "maxdownloadbatchsize": 17825792, // bytes
      "maxduration":          25920,    // blocks
      "maxrevisebatchsize":   17825792, // bytes
      "netaddress":           "123.456.789.2:9982",
      "remainingstorage":     35000000000, // bytes
      "sectorsize":           4194304,     // bytes
      "totalstorage":         35000000000, // bytes
      "unlockhash":           "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789ab",
      "windowsize":           144, // blocks
      "publickey": {
        "algorithm": "ed25519",
        "key":        "RW50cm9weSBpc24ndCB3aGF0IGl0IHVzZWQgdG8gYmU="
      }
    }
  ]
}

/hostdb/all [GET] (example)

lists all of the hosts known to the renter. Hosts are not guaranteed to be in any particular order, and the order may change in subsequent calls.

JSON Response (with comments)
{
  "hosts": [
    {
      "acceptingcontracts":   true,
      "maxdownloadbatchsize": 17825792, // bytes
      "maxduration":          25920,    // blocks
      "maxrevisebatchsize":   17825792, // bytes
      "netaddress":           "123.456.789.0:9982",
      "remainingstorage":     35000000000, // bytes
      "sectorsize":           4194304,     // bytes
      "totalstorage":         35000000000, // bytes
      "unlockhash":           "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789ab",
      "windowsize":           144, // blocks
      "publickey": {
        "algorithm": "ed25519",
        "key":       "RW50cm9weSBpc24ndCB3aGF0IGl0IHVzZWQgdG8gYmU="
      }
    }
  ]
}

Miner

Route HTTP verb
/miner GET
/miner/start GET
/miner/stop GET
/miner/header GET
/miner/header POST

For examples and detailed descriptions of request and response parameters, refer to Miner.md.

/miner [GET]

returns the status of the miner.

JSON Response (with comments)
{
  "blocksmined":      9001,
  "cpuhashrate":      1337,
  "cpumining":        false,
  "staleblocksmined": 0,
}

/miner/start [GET]

starts a single threaded cpu miner. Does nothing if the cpu miner is already running.

Response

standard success or error response. See #standard-responses.

/miner/stop [GET]

stops the cpu miner. Does nothing if the cpu miner is not running.

Response

standard success or error response. See #standard-responses.

/miner/header [GET]

provides a block header that is ready to be grinded on for work.

Byte Response

For efficiency the header for work is returned as a raw byte encoding of the header, rather than encoded to JSON. Refer to Miner.md#byte-response for a detailed description of the byte encoding.

/miner/header [POST]

submits a header that has passed the POW.

Request Body Bytes

For efficiency headers are submitted as raw byte encodings of the header in the body of the request, rather than as a query string parameter or path parameter. The request body should contain only the 80 bytes of the encoded header. The encoding is the same encoding used in /miner/header [GET] endpoint. Refer to Miner.md#byte-response for a detailed description of the byte encoding.

Renter

Route HTTP verb
/renter GET
/renter POST
/renter/contracts GET
/renter/downloads GET
/renter/files GET
/renter/delete/*siapath POST
/renter/download/*siapath GET
/renter/rename/*siapath POST
/renter/upload/*siapath POST

For examples and detailed descriptions of request and response parameters, refer to Renter.md.

/renter [GET]

returns the current settings along with metrics on the renter's spending.

JSON Response (with comments)
{
  "settings": {
    "allowance": {
      "funds":       "1234", // hastings
      "hosts":       24,
      "period":      6048, // blocks
      "renewwindow": 3024  // blocks
    }
  },
  "financialmetrics": {
    "contractspending": "1234", // hastings
    "downloadspending": "5678", // hastings
    "storagespending":  "1234", // hastings
    "uploadspending":   "5678", // hastings
    "unspent":          "1234"  // hastings
  }
}

/renter [POST]

modify settings that control the renter's behavior.

Query String Parameters (with comments)
funds // hastings
hosts
period      // block height
renewwindow // block height
Response

standard success or error response. See #standard-responses.

/renter/contracts [GET]

returns active contracts. Expired contracts are not included.

JSON Response (with comments)
{
  "contracts": [
    {
      "endheight":   50000, // block height
      "id":          "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "netaddress":  "12.34.56.78:9",
      "renterfunds": "1234", // hastings
      "size":        8192    // bytes
    }
  ]
}

/renter/downloads [GET]

lists all files in the download queue.

JSON Response (with comments)
{
  "downloads": [
    {
      "siapath":     "foo/bar.txt",
      "destination": "/home/users/alice/bar.txt",
      "filesize":    8192,                  // bytes
      "received":    4096,                  // bytes
      "starttime":   "2009-11-10T23:00:00Z" // RFC 3339 time
    }
  ]
}

/renter/files [GET]

lists the status of all files.

JSON Response (with comments)
{
  "files": [
    {
      "siapath":        "foo/bar.txt",
      "filesize":       8192, // bytes
      "available":      true,
      "renewing":       true,
      "redundancy":     5,
      "uploadprogress": 100, // percent
      "expiration":     60000
    }
  ]
}

/renter/delete/*siapath [POST]

deletes a renter file entry. Does not delete any downloads or original files, only the entry in the renter.

Path Parameters (with comments)
*siapath
Response

standard success or error response. See #standard-responses.

/renter/download/*siapath [GET]

downloads a file to the local filesystem. The call will block until the file has been downloaded.

Path Parameters (with comments)
*siapath
Query String Parameters (with comments)
destination
Response

standard success or error response. See #standard-responses.

/renter/rename/*siapath [POST]

renames a file. Does not rename any downloads or source files, only renames the entry in the renter. An error is returned if siapath does not exist or newsiapath already exists.

Path Parameters (with comments)
*siapath
Query String Parameters (with comments)
newsiapath
Response

standard success or error response. See #standard-responses.

/renter/upload/*siapath [POST]

uploads a file to the network from the local filesystem.

Path Parameters (with comments)
*siapath
Query String Parameters (with comments)
datapieces   // int
paritypieces // int
source       // string - a filepath
Response

standard success or error response. See #standard-responses.

Wallet

Route HTTP verb
/wallet GET
/wallet/033x POST
/wallet/address GET
/wallet/addresses GET
/wallet/backup GET
/wallet/init POST
/wallet/lock POST
/wallet/seed POST
/wallet/seeds GET
/wallet/siacoins POST
/wallet/siafunds POST
/wallet/siagkey POST
/wallet/transaction/:id GET
/wallet/transactions GET
/wallet/transactions/:addr GET
/wallet/unlock POST

For examples and detailed descriptions of request and response parameters, refer to Wallet.md.

/wallet [GET]

returns basic information about the wallet, such as whether the wallet is locked or unlocked.

JSON Response (with comments)
{
  "encrypted": true,
  "unlocked":  true,

  "confirmedsiacoinbalance":     "123456", // hastings, big int
  "unconfirmedoutgoingsiacoins": "0",      // hastings, big int
  "unconfirmedincomingsiacoins": "789",    // hastings, big int

  "siafundbalance":      "1",    // siafunds, big int
  "siacoinclaimbalance": "9001", // hastings, big int
}

/wallet/033x [POST]

loads a v0.3.3.x wallet into the current wallet, harvesting all of the secret keys. All spendable addresses in the loaded wallet will become spendable from the current wallet.

Query String Parameters (with comments)
source
encryptionpassword
Response

standard success or error response. See #standard-responses.

/wallet/address [GET]

gets a new address from the wallet generated by the primary seed. An error will be returned if the wallet is locked.

JSON Response (with comments)
{
  "address": "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789ab"
}

/wallet/addresses [GET]

fetches the list of addresses from the wallet.

JSON Response (with comments)
{
  "addresses": [
    "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789ab",
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
  ]
}

/wallet/backup [GET]

creates a backup of the wallet settings file. Though this can easily be done manually, the settings file is often in an unknown or difficult to find location. The /wallet/backup call can spare users the trouble of needing to find their wallet file.

Parameters (with comments)
destination
Response

standard success or error response. See #standard-responses.

/wallet/init [POST]

initializes the wallet. After the wallet has been initialized once, it does not need to be initialized again, and future calls to /wallet/init will return an error. The encryption password is provided by the api call. If the password is blank, then the password will be set to the same as the seed.

Query String Parameters (with comments)
encryptionpassword
dictionary // Optional, default is english.
JSON Response (with comments)
{
  "primaryseed": "hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello"
}

/wallet/seed [POST]

gives the wallet a seed to track when looking for incoming transactions. The wallet will be able to spend outputs related to addresses created by the seed. The seed is added as an auxiliary seed, and does not replace the primary seed. Only the primary seed will be used for generating new addresses.

Query String Parameters (with comments)
encryptionpassword
dictionary
seed
Response

standard success or error response. See #standard-responses.

/wallet/seeds [GET]

returns the list of seeds in use by the wallet. The primary seed is the only seed that gets used to generate new addresses. This call is unavailable when the wallet is locked.

Query String Parameters (with comments)
dictionary
JSON Response (with comments)
{
  "primaryseed":        "hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello",
  "addressesremaining": 2500,
  "allseeds":           [
    "hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello world hello",
    "foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo bar foo",
  ]
}

/wallet/siacoins [POST]

sends siacoins to an address. The outputs are arbitrarily selected from addresses in the wallet.

Query String Parameters (with comments)
amount      // hastings
destination // address
JSON Response (with comments)
{
  "transactionids": [
    "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
  ]
}

/wallet/siafunds [POST]

sends siafunds to an address. The outputs are arbitrarily selected from addresses in the wallet. Any siacoins available in the siafunds being sent (as well as the siacoins available in any siafunds that end up in a refund address) will become available to the wallet as siacoins after 144 confirmations. To access all of the siacoins in the siacoin claim balance, send all of the siafunds to an address in your control (this will give you all the siacoins, while still letting you control the siafunds).

Query String Parameters (with comments)
amount      // siafunds
destination // address
JSON Response (with comments)
{
  "transactionids": [
    "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
  ]
}

/wallet/siagkey [POST]

loads a key into the wallet that was generated by siag. Most siafunds are currently in addresses created by siag.

Query String Parameters (with comments)
encryptionpassword
keyfiles
Response

standard success or error response. See #standard-responses.

/wallet/lock [POST]

locks the wallet, wiping all secret keys. After being locked, the keys are encrypted. Queries for the seed, to send siafunds, and related queries become unavailable. Queries concerning transaction history and balance are still available.

Response

standard success or error response. See #standard-responses.

/wallet/transaction/:id [GET]

gets the transaction associated with a specific transaction id.

Path Parameters (with comments)
:id
JSON Response (with comments)
{
  "transaction": {
    "transaction": {
      // See types.Transaction in https://github.com/NebulousLabs/Sia/blob/master/types/transactions.go
    },
    "transactionid":         "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "confirmationheight":    50000,
    "confirmationtimestamp": 1257894000,
    "inputs": [
      {
        "fundtype":       "siacoin input",
        "walletaddress":  false,
        "relatedaddress": "1234567890abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789ab",
        "value":          "1234", // hastings or siafunds, depending on fundtype, big int
      }
    ],
    "outputs": [
      {
        "fundtype":       "siacoin output",
        "maturityheight": 50000,
        "walletaddress":  false,
        "relatedaddress": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "value":          "1234", // hastings or siafunds, depending on fundtype, big int
      }
    ]
  }
}

/wallet/transactions [GET]

returns a list of transactions related to the wallet in chronological order.

Query String Parameters (with comments)
startheight // block height
endheight   // block height
JSON Response (with comments)
{
  "confirmedtransactions": [
    {
      // See the documentation for '/wallet/transaction/:id' for more information.
    }
  ],
  "unconfirmedtransactions": [
    {
      // See the documentation for '/wallet/transaction/:id' for more information.
    }
  ]
}

/wallet/transactions/:addr [GET]

returns all of the transactions related to a specific address.

Path Parameters (with comments)
:addr
JSON Response (with comments)
{
  "transactions": [
    {
      // See the documentation for '/wallet/transaction/:id' for more information.
    }
  ]
}

/wallet/unlock [POST]

unlocks the wallet. The wallet is capable of knowing whether the correct password was provided.

Query String Parameters (with comments)
encryptionpassword
Response

standard success or error response. See #standard-responses.