mirror of
https://github.com/Qortal/altcoinj.git
synced 2025-02-07 23:03:04 +00:00
70 lines
3.1 KiB
Protocol Buffer
70 lines
3.1 KiB
Protocol Buffer
/** Copyright 2013 Google Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/*
|
|
* Authors: Mike Hearn, Gavin Andresen
|
|
*/
|
|
|
|
/* Notes:
|
|
* - Endianness: All byte arrays that represent numbers (such as hashes and private keys) are Big Endian
|
|
* - To regenerate after editing, run mvn clean package -DupdateProtobuf
|
|
*/
|
|
|
|
//
|
|
// Simple Bitcoin Payment Protocol messages
|
|
//
|
|
// Use fields 100+ for extensions;
|
|
// to avoid conflicts, register extensions at:
|
|
// https://en.bitcoin.it/wiki/Payment_Request
|
|
//
|
|
|
|
package payments;
|
|
option java_package = "org.bitcoin.protocols.payments";
|
|
option java_outer_classname = "Protos";
|
|
|
|
// Generalized form of "send payment to this/these bitcoin addresses"
|
|
message Output {
|
|
optional uint64 amount = 1 [default = 0]; // amount is integer-number-of-satoshis
|
|
required bytes script = 2; // usually one of the standard Script forms
|
|
}
|
|
message PaymentDetails {
|
|
optional string network = 1 [default = "main"]; // "main" or "test"
|
|
repeated Output outputs = 2; // Where payment should be sent
|
|
required uint64 time = 3; // Timestamp; when payment request created
|
|
optional uint64 expires = 4; // Timestamp; when this request should be considered invalid
|
|
optional string memo = 5; // Human-readable description of request for the customer
|
|
optional string payment_url = 6; // URL to send Payment and get PaymentACK
|
|
optional bytes merchant_data = 7; // Arbitrary data to include in the Payment message
|
|
}
|
|
message PaymentRequest {
|
|
optional uint32 payment_details_version = 1 [default = 1];
|
|
optional string pki_type = 2 [default = "none"]; // none / x509+sha256 / x509+sha1
|
|
optional bytes pki_data = 3; // depends on pki_type
|
|
required bytes serialized_payment_details = 4; // PaymentDetails
|
|
optional bytes signature = 5; // pki-dependent signature
|
|
}
|
|
message X509Certificates {
|
|
repeated bytes certificate = 1; // DER-encoded X.509 certificate chain
|
|
}
|
|
message Payment {
|
|
optional bytes merchant_data = 1; // From PaymentDetails.merchant_data
|
|
repeated bytes transactions = 2; // Signed transactions that satisfy PaymentDetails.outputs
|
|
repeated Output refund_to = 3; // Where to send refunds, if a refund is necessary
|
|
optional string memo = 4; // Human-readable message for the merchant
|
|
}
|
|
message PaymentACK {
|
|
required Payment payment = 1; // Payment message that triggered this ACK
|
|
optional string memo = 2; // human-readable message for customer
|
|
} |