VerifyAcceptQuote

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

Source: portfoliopilotrpc/portfolio_pilot.proto

gRPC

rpc VerifyAcceptQuote (VerifyAcceptQuoteRequest) returns (VerifyAcceptQuoteResponse);

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

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	unknown	unknown

portfoliopilotrpc.VerifyAcceptQuoteResponse

Source: portfoliopilotrpc/portfolio_pilot.proto

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

Nested Messages

portfoliopilotrpc.AcceptedQuote

Field	gRPC Type	REST Type
peer_id peer_id is the 33-byte public key of the accepting peer.	bytes	unknown
accepted_rate accepted_rate is the asset rate accepted by the peer.	AssetRate	unknown
buy_request buy_request is the original buy request.	BuyRequest	unknown
sell_request sell_request is the original sell request.	SellRequest	unknown
accepted_max_amount accepted_max_amount is the optional negotiated fill quantity. 0 means no fill cap (full request max). The unit depends on the request type: asset units for a buy request, msat for a sell request.	uint64	unknown

portfoliopilotrpc.AssetRate

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

portfoliopilotrpc.AssetSpecifier

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

portfoliopilotrpc.BuyRequest

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

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	unknown
scale The scale is the component that determines how many decimal places the coefficient should be divided by to obtain the fractional value.	uint32	unknown

portfoliopilotrpc.SellRequest

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

Enums

portfoliopilotrpc.ExecutionPolicy

Name	Number
EXECUTION_POLICY_IOC EXECUTION_POLICY_IOC (Immediate-Or-Cancel) accepts any partial fill. This is the default policy.	0
EXECUTION_POLICY_FOK EXECUTION_POLICY_FOK (Fill-Or-Kill) requires the accepted rate to satisfy the full requested amount.	1

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
FOK_NOT_VIABLE FOK_NOT_VIABLE indicates that the FOK execution policy could not be satisfied at the accepted rate.	7
FILL_EXCEEDS_MAX FILL_EXCEEDS_MAX indicates that the negotiated fill amount exceeds the requester's maximum.	8