VerifyAcceptQuote

VerifyAcceptQuote verifies that an accepted quote from a peer meets acceptable conditions.

Source: portfoliopilotrpc/portfolio_pilot.proto

gRPC

rpc VerifyAcceptQuote (VerifyAcceptQuoteRequest) returns (VerifyAcceptQuoteResponse);

REST

HTTP Method	Path
POST	/v1/taproot-assets/rfq/portfoliopilot/verify

Code Samples

gRPC

Javascript

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

const GRPC_HOST = 'localhost:10029'
const MACAROON_PATH = 'TAPD_DIR/data/regtest/admin.macaroon'
const TLS_PATH = 'TAPD_DIR/tls.cert'

const loaderOptions = {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true,
};
const packageDefinition = protoLoader.loadSync('portfoliopilotrpc/portfolio_pilot.proto', loaderOptions);
const portfoliopilotrpc = grpc.loadPackageDefinition(packageDefinition).portfoliopilotrpc;
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 portfoliopilotrpc.PortfolioPilot(GRPC_HOST, creds);
let request = {
  accept: <AcceptedQuote>,
};
client.verifyAcceptQuote(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "status": <QuoteRespStatus>,
//  }

Python

import codecs, grpc, os
# Generate the following 2 modules by compiling the portfoliopilotrpc/portfolio_pilot.proto with the grpcio-tools.
# See https://github.com/lightningnetwork/lnd/blob/master/docs/grpc/python.md for instructions.
import portfolio_pilot_pb2 as portfoliopilotrpc, portfolio_pilot_pb2_grpc as portfolio_pilotstub

GRPC_HOST = 'localhost:10029'
MACAROON_PATH = 'TAPD_DIR/data/regtest/admin.macaroon'
TLS_PATH = 'TAPD_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 = portfolio_pilotstub.PortfolioPilotStub(channel)
request = portfoliopilotrpc.VerifyAcceptQuoteRequest(
  accept=<AcceptedQuote>,
)
response = stub.VerifyAcceptQuote(request)
print(response)
# {
#    "status": <QuoteRespStatus>,
# }

grpcurl

# grpcurl docs: https://github.com/fullstorydev/grpcurl
# Proto source: https://github.com/lightninglabs/taproot-assets
GRPC_HOST=localhost:10029
TAPD_DIR=~/.tapd
TAPD_SOURCE=path/to/taproot-assets
NETWORK=mainnet
MACAROON_PATH="$TAPD_DIR/data/$NETWORK/admin.macaroon"
TLS_PATH="$TAPD_DIR/tls.cert"

grpcurl \
    -import-path $TAPD_SOURCE/taprpc/ \
    -proto portfoliopilotrpc/portfolio_pilot.proto \
    -cacert $TLS_PATH \
    -H "macaroon: $(xxd -ps -u -c 1000 $MACAROON_PATH)" \
    -d '{ "accept": <AcceptedQuote> }' \
    $GRPC_HOST \
    portfoliopilotrpc.PortfolioPilot/VerifyAcceptQuote

REST

Javascript

const fs = require('fs');
const request = require('request');

const REST_HOST = 'localhost:8089'
const MACAROON_PATH = 'TAPD_DIR/data/regtest/admin.macaroon'

let requestBody = {
  accept: <object>, // <AcceptedQuote> 
};
let options = {
  url: `https://${REST_HOST}/v1/taproot-assets/rfq/portfoliopilot/verify`,
  // Work-around for self-signed certificates.
  rejectUnauthorized: false,
  json: true,
  headers: {
    'Grpc-Metadata-macaroon': fs.readFileSync(MACAROON_PATH).toString('hex'),
  },
  form: JSON.stringify(requestBody),
}
request.post(options, function(error, response, body) {
  console.log(body);
});
// Console output:
//  {
//    "status": <string>, // <QuoteRespStatus> 
//  }

Python

import base64, codecs, json, requests

REST_HOST = 'localhost:8089'
MACAROON_PATH = 'TAPD_DIR/data/regtest/admin.macaroon'
TLS_PATH = 'TAPD_DIR/tls.cert'

url = f'https://{REST_HOST}/v1/taproot-assets/rfq/portfoliopilot/verify'
macaroon = codecs.encode(open(MACAROON_PATH, 'rb').read(), 'hex')
headers = {'Grpc-Metadata-macaroon': macaroon}
data = {
  'accept': <AcceptedQuote>,
}
r = requests.post(url, headers=headers, data=json.dumps(data), verify=TLS_PATH)
print(r.json())
# {
#    "status": <QuoteRespStatus>,
# }

curl

REST_HOST=localhost:8089
TAPD_DIR=~/.tapd
NETWORK=mainnet
MACAROON_PATH="$TAPD_DIR/data/$NETWORK/admin.macaroon"
TLS_PATH="$TAPD_DIR/tls.cert"

curl -X POST \
    --cacert $TLS_PATH \
    -H "Grpc-Metadata-macaroon: $(xxd -ps -u -c 1000 $MACAROON_PATH)" \
    -d '{ "accept": <AcceptedQuote> }' \
    https://$REST_HOST/v1/taproot-assets/rfq/portfoliopilot/verify

Messages

portfoliopilotrpc.VerifyAcceptQuoteRequest

Source: portfoliopilotrpc/portfolio_pilot.proto

Field	gRPC Type	REST Type	REST Placement
accept accept is the accepted quote and request details.	AcceptedQuote	object	body

portfoliopilotrpc.VerifyAcceptQuoteResponse

Source: portfoliopilotrpc/portfolio_pilot.proto

Field	gRPC Type	REST Type
status status is the verification result.	QuoteRespStatus	string

Nested Messages

portfoliopilotrpc.AcceptedQuote

Field	gRPC Type	REST Type
peer_id peer_id is the 33-byte public key of the accepting peer.	bytes	string
accepted_rate accepted_rate is the asset rate accepted by the peer.	AssetRate	object
buy_request buy_request is the original buy request.	BuyRequest	object
sell_request sell_request is the original sell request.	SellRequest	object

portfoliopilotrpc.AssetRate

Field	gRPC Type	REST Type
rate rate is the asset to BTC conversion rate represented as a fixed-point number.	FixedPoint	object
expiry_timestamp expiry_timestamp is the Unix timestamp in seconds after which the rate is no longer valid.	uint64	string

portfoliopilotrpc.AssetSpecifier

Field	gRPC Type	REST Type
asset_id The 32-byte asset ID specified as raw bytes (gRPC only).	bytes	string
asset_id_str The 32-byte asset ID encoded as a hex string (use this for REST).	string	string
group_key The 32-byte asset group key specified as raw bytes (gRPC only).	bytes	string
group_key_str The 32-byte asset group key encoded as hex string (use this for REST).	string	string

portfoliopilotrpc.BuyRequest

Field	gRPC Type	REST Type
asset_specifier asset_specifier is the subject asset.	AssetSpecifier	object
asset_max_amount asset_max_amount is the maximum amount of the asset that the peer must be willing to offer.	uint64	string
asset_rate_hint asset_rate_hint is an optional suggested asset rate for the request.	AssetRate	object
price_oracle_metadata price_oracle_metadata is optional metadata for pricing decisions.	string	string
peer_id peer_id is the 33-byte public key of the counterparty peer.	bytes	string
asset_min_amount asset_min_amount is an optional minimum asset amount. A value of 0 means unset.	uint64	string
asset_rate_limit asset_rate_limit is an optional minimum acceptable rate (asset units per BTC).	FixedPoint	object

portfoliopilotrpc.FixedPoint

Field	gRPC Type	REST Type
coefficient The coefficient is the fractional value scaled-up as an integer. This integer is represented as a string as it may be too large to fit in a uint64.	string	string
scale The scale is the component that determines how many decimal places the coefficient should be divided by to obtain the fractional value.	uint32	integer

portfoliopilotrpc.SellRequest

Field	gRPC Type	REST Type
asset_specifier asset_specifier is the subject asset.	AssetSpecifier	object
payment_max_amount payment_max_amount is the maximum msat amount that the peer must agree to pay.	uint64	string
asset_rate_hint asset_rate_hint is an optional suggested asset rate for the request.	AssetRate	object
price_oracle_metadata price_oracle_metadata is optional metadata for pricing decisions.	string	string
peer_id peer_id is the 33-byte public key of the counterparty peer.	bytes	string
payment_min_amount payment_min_amount is an optional minimum msat amount. A value of 0 means unset.	uint64	string
asset_rate_limit asset_rate_limit is an optional maximum acceptable rate (asset units per BTC).	FixedPoint	object

Enums

portfoliopilotrpc.QuoteRespStatus

Name	Number
INVALID_ASSET_RATES INVALID_ASSET_RATES indicates that at least one asset rate in the quote response is invalid.	0
INVALID_EXPIRY INVALID_EXPIRY indicates that the expiry in the quote response is invalid.	1
PRICE_ORACLE_QUERY_ERR PRICE_ORACLE_QUERY_ERR indicates that an error occurred when querying the price oracle whilst evaluating the quote response.	2
PORTFOLIO_PILOT_ERR PORTFOLIO_PILOT_ERR indicates that an unexpected error occurred in the portfolio pilot while evaluating the quote response.	3
VALID_ACCEPT_QUOTE VALID_ACCEPT_QUOTE indicates that the accepted quote passed all validation checks successfully.	4
MIN_FILL_NOT_MET MIN_FILL_NOT_MET indicates that the minimum fill constraint was not satisfiable at the accepted rate.	5
RATE_BOUND_MISS RATE_BOUND_MISS indicates that the accepted rate violated the requester's rate limit constraint.	6