Create orchestration

cURL

curl --request POST \
  --url https://api.otim.com/orchestration/new \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "signedAuthorization": "<string>",
  "completionInstructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "activationSignature": {
        "yParity": 0,
        "r": "0x...",
        "s": "0x..."
      },
      "nickname": "My cool instruction"
    }
  ],
  "instructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "activationSignature": {
        "yParity": 0,
        "r": "0x...",
        "s": "0x..."
      },
      "nickname": "My cool instruction"
    }
  ]
}
'

POST

orchestration

new

cURL

curl --request POST \
  --url https://api.otim.com/orchestration/new \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "signedAuthorization": "<string>",
  "completionInstructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "activationSignature": {
        "yParity": 0,
        "r": "0x...",
        "s": "0x..."
      },
      "nickname": "My cool instruction"
    }
  ],
  "instructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "activationSignature": {
        "yParity": 0,
        "r": "0x...",
        "s": "0x..."
      },
      "nickname": "My cool instruction"
    }
  ]
}
'

Create a new orchestration.

Authorizations

Authorization

string

header

required

JWT token for API authentication

Body

application/json

requestId

string<uuid>

required

Orchestration ID

signedAuthorization

string

required

RLP encoded signed authorization

completionInstructions

object[]

required

Completion instructions

Show child attributes

completionInstructions.address

string<address>

required

Address of the user

Example:

"0xa0Ee7A142d267C1f36714E4a8F75612F20a79720"

completionInstructions.chainId

integer<uint64>

required

Chain ID

Example:

11155111

completionInstructions.salt

integer<uint256>

required

Salt to ensure instruction is unique

Example:

1234567890

completionInstructions.maxExecutions

integer<uint256>

required

Maximum number of times this instruction can be executed (0 for unlimited)

Example:

10

completionInstructions.action

string<address>

required

Action contract address

Example:

"0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef"

completionInstructions.arguments

string<bytes>

required

Arguments to execute on the action contract

Example:

"0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"

completionInstructions.activationSignature

object

required

User signature over the activation hash

Show child attributes

completionInstructions.activationSignature.yParity

enum<number>

Y parity of the signature

Available options:

0,

1

Example:

0

completionInstructions.activationSignature.r

string<bytes>

R of the signature

Example:

"0x..."

completionInstructions.activationSignature.s

string<bytes>

S of the signature

Example:

"0x..."

completionInstructions.nickname

string | null

Instruction nickname

Example:

"My cool instruction"

instructions

object[]

required

Instructions

Show child attributes

instructions.address

string<address>

required

Address of the user

Example:

"0xa0Ee7A142d267C1f36714E4a8F75612F20a79720"

instructions.chainId

integer<uint64>

required

Chain ID

Example:

11155111

instructions.salt

integer<uint256>

required

Salt to ensure instruction is unique

Example:

1234567890

instructions.maxExecutions

integer<uint256>

required

Maximum number of times this instruction can be executed (0 for unlimited)

Example:

10

instructions.action

string<address>

required

Action contract address

Example:

"0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef"

instructions.arguments

string<bytes>

required

Arguments to execute on the action contract

Example:

instructions.activationSignature

object

required

User signature over the activation hash

Show child attributes

instructions.activationSignature.yParity

enum<number>

Y parity of the signature

Available options:

0,

1

Example:

0

instructions.activationSignature.r

string<bytes>

R of the signature

Example:

"0x..."

instructions.activationSignature.s

string<bytes>

S of the signature

Example:

"0x..."

instructions.nickname

string | null

Instruction nickname

Example:

"My cool instruction"

Response

201

Orchestration created successfully

Build settlement orchestration Get orchestration details

⌘I

Using the API

Otim APIs

Authorizations

Body

Response