Skip to content
You are reading Orion development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

Client API

The Client API is used by Ethereum clients (for example, Hyperledger Besu) to interact with Orion.

The port used by the Client API is defined by the clientport property in the configuration file. The default port is 8888.

Methods

createPrivacyGroup

Creates a privacy group with the specified members.

HTTP Verb

POST

Headers

  • Content-Type: application/json

Request Body

addresses : array of strings - Orion node keys to include in the privacy group

from : string - Orion node key of node creating the privacy group

name : string - Name of the privacy group

description : string - Description for the privacy group

Returns

privacy group : object - Privacy group object

Example

curl -X POST http://127.0.0.1:8888/createPrivacyGroup \
  -H 'Content-Type: application/json' \
  -d '{
    "addresses": [
      "g59BmTeJIn7HIcnq8VQWgyh/pDbvbt2eyP0Ii60aDDw=",
      "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk="
    ],
    "from": "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk=",
   "name": "Organisation A",
   "description": "Contains members of Organisation A"
 }'
{"privacyGroupId":
  "C68ZfeG6wHeXb+CyfwS6NjmmaMWwRaj8ZkrPq/o+S8Q=",
  "name":"Organisation A",
  "description":"Contains members of Organisation A",
  "type":"PANTHEON",
  "members":["g59BmTeJIn7HIcnq8VQWgyh/pDbvbt2eyP0Ii60aDDw=","negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk="]
}

deletePrivacyGroup

Deletes a privacy group.

HTTP Verb

POST

Headers

  • Content-Type: application/json

Request Body

privacyGroupId : string - ID of the privacy group to delete

from : string - Orion node key of node deleting the privacy group

Returns

privacyGroupId : string - ID of the deleted privacy group

Example

curl -X POST http://127.0.0.1:8888/deletePrivacyGroup \
  -H 'Content-Type: application/json' \
  -d '{
    "privacyGroupId": "C68ZfeG6wHeXb+CyfwS6NjmmaMWwRaj8ZkrPq/o+S8Q=",
    "from": "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk="
  }'
    curl -X POST http://127.0.0.1:8888/send \
      -H 'Content-Type: application/json' \
      -d '{
        "payload": "SGVsbG8sIFdvcmxkIQ==",
        "from": "4xanJzyaDPcBVMUSwl/tLp+DbXzd3jF9MKk1yJuyewE=",
        "privacyGroupId": "kAbelwaVW7okoEn1+okO+AbA4Hhz/7DaCOWVQz9nx5M="
    }'
"C68ZfeG6wHeXb+CyfwS6NjmmaMWwRaj8ZkrPq/o+S8Q="

findPrivacyGroup

Finds all privacy groups containing only the specified members.

HTTP Verb

POST

Headers

  • Content-Type: application/json

Request Body

addresses : array of strings - Orion node keys for which to return privacy groups

Returns

array of objects - Privacy group objects for all privacy groups containing only the specified members

Example

curl -X POST http://127.0.0.1:8888/findPrivacyGroup \
  -H 'Content-Type: application/json' \
  -d '{
  "addresses" : [
      "g59BmTeJIn7HIcnq8VQWgyh/pDbvbt2eyP0Ii60aDDw=",
      "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk="
  ]
}'
[
  {
    "privacyGroupId": "DVMXn3N6VIerZOJjixFFoGQBu8AleyonJ1sK33aYdtg=",
    "type": "PANTHEON",
    "members": [
      "g59BmTeJIn7HIcnq8VQWgyh/pDbvbt2eyP0Ii60aDDw=",
      "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk="
    ]
  }
]

knownnodes

Returns the public key and URL of nodes discovered by Orion.

HTTP Verb

GET

Headers

None

Request Body

None

Returns

array of objects - Public key and URL of each discovered node.

Example

curl -X GET http://127.0.0.1:8888/knownnodes
[
  {
    "publicKey": "i/6jwvVSK/V2qvbXSuXG6/jEHZFcjkE/qLD3rs47PDs=",
    "nodeUrl": "http://127.0.0.1:8080/"
  },
  {
    "publicKey": "Gy/mgkqgCZ960o9pmYAONmPHRD0LDH/5ymywNLrzz08=",
    "nodeUrl": "http://127.0.0.1:9090/"
  }
]

receive

Receives a payload from Orion using the payload key. The payload key is returned by the send method.

HTTP Verb

POST

Headers

  • Content-Type: application/json

Request Body

key : string - Key used to receive the payload

to : string - Orion key of the receiver

Returns

payload : string - Base64 encoded payload

Example

curl -X POST http://127.0.0.1:8888/receive \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "wS+RMprLKIuCaHzOBfPeHmkJWUdOJ7Ji/9U3qj2jbXQ=",
    "to": "YE5cJRJYTRO4XFo7yuAi/0K9DwjySGjsHB2YrFPnJXo="
}'
 {"payload":"SGVsbG8sIFdvcmxkIQ=="}

receive with privacy group ID

To return the privacy group ID with the payload, use the receive method with the header Content-Type: application/vnd.orion.v1+json.

Example

curl -X POST \
  http://127.0.0.1:8888/receive \
  -H 'Content-Type: application/vnd.orion.v1+json' \
  -d '{
    "key": "dRQUqPeGy6sj9LQJUYqNlUFroBiWm/tJO+CriTce6AA=",
    "to": "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk="
}'
 {
     "payload": "SGVsbG8sIFdvcmxkIQ==",
     "privacyGroupId": "68/Cq0mVjB8FbXDLE1tbDRAvD/srluIok137uFOaClM="
 }

receiveraw

Receives a raw payload from Orion using the payload key. The payload key is returned by the sendraw method

HTTP Verb

POST

Headers

  • Content-Type: application/octet-stream
  • c11n-key: Key used to receive the payload

Request Body

None

Returns

Payload

Example

curl -X POST \
  http://127.0.0.1:8888/receiveraw \
  -H 'Content-Type: application/octet-stream' \
  -H 'c11n-key: +3gnwO0oHXe4kXsr3kegd9jTTqsq3Y6Hm3w26WHR/RM='
Hello, World!

send

Sends a payload to Orion.

HTTP Verb

POST

Headers

  • Content-Type: application/json

Request Body

payload : string - Base64-encoded payload

from : string - Orion node key of sender

to : array of strings - Orion node keys to receive this payload

or

privacyGroupId : string - Privacy group to receive this payload

Returns

key : string - Key used to receive the payload

Example

curl -X POST http://127.0.0.1:8888/send \
  -H 'Content-Type: application/json' \
  -d '{
    "payload": "SGVsbG8sIFdvcmxkIQ==",
    "from": "4xanJzyaDPcBVMUSwl/tLp+DbXzd3jF9MKk1yJuyewE=",
    "to": ["YE5cJRJYTRO4XFo7yuAi/0K9DwjySGjsHB2YrFPnJXo="]
}'
curl -X POST http://127.0.0.1:8888/send \
   -H 'Content-Type: application/json' \
   -d '{
     "payload": "SGVsbG8sIFdvcmxkIQ==",
     "from": "negmDcN2P4ODpqn/6WkJ02zT/0w0bjhGpkZ8UP6vARk=",
     "privacyGroupId": "DVMXn3N6VIerZOJjixFFoGQBu8AleyonJ1sK33aYdtg="
}'
{"key":"wS+RMprLKIuCaHzOBfPeHmkJWUdOJ7Ji/9U3qj2jbXQ="}

sendraw

Sends a raw payload to Orion.

HTTP Verb

POST

Headers

  • Content-Type: application/octet-stream
  • c11n-from: Orion node key of the sender
  • c11n-to: List of Orion node keys to receive this payload

Request Body

payload : string - Payload

Returns

Key used to receive the payload

Example

curl -X POST http://127.0.0.1:8888/sendraw \
  -H 'Content-Type: application/octet-stream' \
  -H 'c11n-from: 4xanJzyaDPcBVMUSwl/tLp+DbXzd3jF9MKk1yJuyewE=' \
  -H 'c11n-to: YE5cJRJYTRO4XFo7yuAi/0K9DwjySGjsHB2YrFPnJXo=' \
  -d 'Hello, World!'
+3gnwO0oHXe4kXsr3kegd9jTTqsq3Y6Hm3w26WHR/RM=

upcheck

Confirms if Orion is running.

HTTP Verb

GET

Headers

None

Request Body

None

Returns

string : I’m up

Example

curl -X GET http://127.0.0.1:8888/upcheck
I'm up
ConsenSys has acquired Quorum from J.P. Morgan. Please read the FAQ.
Questions or feedback? You can discuss issues and obtain free support on Orion Discord channel.
For paid professional support by Consensys, contact us at quorum@consensys.net