DecodeSidecarTicket

Decodes the base58 encoded sidecar ticket into its individual data fields for a more human-readable representation.

Source: poolrpc/trader.proto

gRPC

rpc DecodeSidecarTicket (SidecarTicket) returns (DecodedSidecarTicket);

Code Samples

gRPC

Javascript

const fs = require('fs');
const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');

const GRPC_HOST = 'localhost:12010'
const MACAROON_PATH = 'POOL_DIR/regtest/pool.macaroon'
const TLS_PATH = 'POOL_DIR/tls.cert'

const loaderOptions = {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true,
};
const packageDefinition = protoLoader.loadSync('poolrpc/trader.proto', loaderOptions);
const poolrpc = grpc.loadPackageDefinition(packageDefinition).poolrpc;
process.env.GRPC_SSL_CIPHER_SUITES = 'HIGH+ECDSA';
const tlsCert = fs.readFileSync(TLS_PATH);
const sslCreds = grpc.credentials.createSsl(tlsCert);
const macaroon = fs.readFileSync(MACAROON_PATH).toString('hex');
const macaroonCreds = grpc.credentials.createFromMetadataGenerator(function(args, callback) {
  let metadata = new grpc.Metadata();
  metadata.add('macaroon', macaroon);
  callback(null, metadata);
});
let creds = grpc.credentials.combineChannelCredentials(sslCreds, macaroonCreds);
let client = new poolrpc.Trader(GRPC_HOST, creds);
let request = {
  ticket: <string>,
};
client.decodeSidecarTicket(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "id": <bytes>,
//    "version": <uint32>,
//    "state": <string>,
//    "offer_capacity": <uint64>,
//    "offer_push_amount": <uint64>,
//    "offer_lease_duration_blocks": <uint32>,
//    "offer_sign_pubkey": <bytes>,
//    "offer_signature": <bytes>,
//    "offer_auto": <bool>,
//    "recipient_node_pubkey": <bytes>,
//    "recipient_multisig_pubkey": <bytes>,
//    "recipient_multisig_pubkey_index": <uint32>,
//    "order_bid_nonce": <bytes>,
//    "order_signature": <bytes>,
//    "execution_pending_channel_id": <bytes>,
//    "encoded_ticket": <string>,
//    "offer_unannounced_channel": <bool>,
//    "offer_zero_conf_channel": <bool>,
//  }

Python

import codecs, grpc, os
# Generate the following 2 modules by compiling the poolrpc/trader.proto with the grpcio-tools.
# See https://github.com/lightningnetwork/lnd/blob/master/docs/grpc/python.md for instructions.
import trader_pb2 as poolrpc, trader_pb2_grpc as traderstub

GRPC_HOST = 'localhost:12010'
MACAROON_PATH = 'POOL_DIR/regtest/pool.macaroon'
TLS_PATH = 'POOL_DIR/tls.cert'

# create macaroon credentials
macaroon = codecs.encode(open(MACAROON_PATH, 'rb').read(), 'hex')
def metadata_callback(context, callback):
  callback([('macaroon', macaroon)], None)
auth_creds = grpc.metadata_call_credentials(metadata_callback)
# create SSL credentials
os.environ['GRPC_SSL_CIPHER_SUITES'] = 'HIGH+ECDSA'
cert = open(TLS_PATH, 'rb').read()
ssl_creds = grpc.ssl_channel_credentials(cert)
# combine macaroon and SSL credentials
combined_creds = grpc.composite_channel_credentials(ssl_creds, auth_creds)
# make the request
channel = grpc.secure_channel(GRPC_HOST, combined_creds)
stub = traderstub.TraderStub(channel)
request = poolrpc.SidecarTicket(
  ticket=<string>,
)
response = stub.DecodeSidecarTicket(request)
print(response)
# {
#    "id": <bytes>,
#    "version": <uint32>,
#    "state": <string>,
#    "offer_capacity": <uint64>,
#    "offer_push_amount": <uint64>,
#    "offer_lease_duration_blocks": <uint32>,
#    "offer_sign_pubkey": <bytes>,
#    "offer_signature": <bytes>,
#    "offer_auto": <bool>,
#    "recipient_node_pubkey": <bytes>,
#    "recipient_multisig_pubkey": <bytes>,
#    "recipient_multisig_pubkey_index": <uint32>,
#    "order_bid_nonce": <bytes>,
#    "order_signature": <bytes>,
#    "execution_pending_channel_id": <bytes>,
#    "encoded_ticket": <string>,
#    "offer_unannounced_channel": <bool>,
#    "offer_zero_conf_channel": <bool>,
# }

Shell

$ pool sidecar printticket --help

NAME:
   pool sidecar printticket - decode and print the content of a sidecar ticket

USAGE:
   pool sidecar printticket ticket

DESCRIPTION:
   
  Tries to decode the given ticket from the human readable (prefixed)
  base64 encoded version.

Messages

poolrpc.SidecarTicket

Source: poolrpc/trader.proto

Field	gRPC Type	REST Type	REST Placement
ticket The complete sidecar ticket in its string encoded form which is base58 encoded, has a human readable prefix ('sidecar...') and a checksum built in. The string encoded version will only be used on the trader side of the API. All requests to the auctioneer expect the ticket to be in its raw, tlv encoded byte form.	string	string	unknown

poolrpc.DecodedSidecarTicket

Source: poolrpc/trader.proto

Field	gRPC Type	REST Type
id The unique, pseudorandom identifier of the ticket.	bytes	string
version The version of the ticket encoding format.	uint32	integer
state The state of the ticket.	string	string
offer_capacity The offered channel capacity in satoshis.	uint64	string
offer_push_amount The offered push amount in satoshis.	uint64	string
offer_lease_duration_blocks The offered lease duration in blocks.	uint32	integer
offer_sign_pubkey The public key the offer was signed with.	bytes	string
offer_signature The signature over the offer's digest.	bytes	string
offer_auto Whether the offer was created with the automatic order creation flag.	bool	boolean
recipient_node_pubkey The recipient node's public identity key.	bytes	string
recipient_multisig_pubkey The recipient node's channel multisig public key to be used for the sidecar channel.	bytes	string
recipient_multisig_pubkey_index The index used when deriving the above multisig pubkey.	uint32	integer
order_bid_nonce The nonce of the bid order created for this sidecar ticket.	bytes	string
order_signature The signature over the order's digest, signed with the private key that corresponds to the offer_sign_pubkey.	bytes	string
execution_pending_channel_id The pending channel ID of the sidecar channel during the execution phase.	bytes	string
encoded_ticket The original, base58 encoded ticket.	string	string
offer_unannounced_channel If true, the channel acceptor for this ticket will expect an unannounced channel.	bool	boolean
offer_zero_conf_channel If true, the channel acceptor for this ticket will expect a zero conf channel.	bool	boolean