Raw Signing

Raw Signing is primarily used with Fireblocks (see Providers) & must be enabled on the Fireblocks workspace before being used. This is an advanced feature.

This requires specific permissions granted in the Connect Widget flow.

Create raw signature request

post

Creates a new raw signature request to be sent to the provider

Authorizations

Detached-JWS-SignatureGNAP

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Body

sourceone ofRequired

or

idempotenceIdstringRequired

requestIdstringOptional

algorithmstringOptional

Responses

201

Raw request created successfully

application/json

400

Invalid request parameters

application/json

401

Authentication is required

application/json

403

Insufficient permissions

application/json

404

Resource not found

application/json

409

Resource conflict

application/json

422

Unable to process the contained instructions

application/json

500

Internal server error

application/json

502

Bad gateway

application/json

post

HTTPcURLJavaScriptPython

POST /v1/provider/sign-raw HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "data": [
    {
      "content": null
    }
  ],
  "source": {
    "type": "account",
    "id": "text"
  },
  "idempotenceId": "text",
  "requestId": "text",
  "algorithm": "text"
}

{
  "data": {
    "requestId": "text",
    "status": "text",
    "data": [
      {
        "content": null
      }
    ],
    "externalStatus": "text",
    "externalId": "text",
    "algorithm": "secp256k1_ecdsa",
    "idempotenceId": "text",
    "signedMessages": [
      {
        "content": null,
        "signature": {
          "r": null,
          "s": null,
          "v": null,
          "fullSig": "text"
        },
        "algorithm": "text",
        "publicKey": "text"
      }
    ]
  }
}

Get raw signature request

get

Retrieves a raw signature request by its ID

Authorizations

Detached-JWS-SignatureGNAP

Path parameters

idstringRequired

The ID of the raw request

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Responses

200

Raw signature request retrieved successfully

application/json

400

Invalid request parameters

application/json

401

Authentication is required

application/json

403

Insufficient permissions

application/json

404

Resource not found

application/json

409

Resource conflict

application/json

422

Unable to process the contained instructions

application/json

500

Internal server error

application/json

502

Bad gateway

application/json

get

HTTPcURLJavaScriptPython

GET /v1/provider/sign-raw/{id} HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Accept: */*

{
  "data": {
    "requestId": "text",
    "status": "text",
    "data": [
      {
        "content": null
      }
    ],
    "externalStatus": "text",
    "externalId": "text",
    "algorithm": "secp256k1_ecdsa",
    "idempotenceId": "text",
    "signedMessages": [
      {
        "content": null,
        "signature": {
          "r": null,
          "s": null,
          "v": null,
          "fullSig": "text"
        },
        "algorithm": "text",
        "publicKey": "text"
      }
    ]
  }
}