stellar-base 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee9599bb2ea3b55e55516019cbe4afaa3905d8791eb807cfa3f8e7d1fd45c8cc
-  data.tar.gz: 61f3f0d3b1627831ef9a386083963a88a3ab93df1e0d7c2ea949a02213e8b905
+  metadata.gz: 3b8dff89d6b3abd5d98273482fba0c6f8eb53dad18fb7ec52db7b92cc39f9f55
+  data.tar.gz: 1d33ebd79f033631a5a0bc3e9ff007c120a5318da4210b4af02b32c2a92b01ca
 SHA512:
-  metadata.gz: 27ff0126aed943226f8b8c27e947de7d064ff1811b869b2a35366aa97a045cd964a98ba1e6651e70c8d2faf38cf9c798dd2f920f22ae91e2ebfb557cab4eef1f
-  data.tar.gz: d4708f217a557fb3a393186dab70fbf2b2bbcf4cf0102e216339ab89a0aba3dc83e90bcaf9f6263dc330f0b5fc97dcbe5148638e60bd259c221153badcfe02fb
+  metadata.gz: ed5867a1d348e71b9d8c2075fedadb9028eefd227b0db6f634d33b29c98413dea0b9f8c5684f5be703eec2cc1b1311167093131bf5d367b8bbc678f9bc63500d
+  data.tar.gz: fd80f67dda204736abd078f1f64617ca93534e02baffd59042f7512d83e9603408ffc1df81f4b8c344416460fb8956d199a33727e54d4211f32bad2207495701

data/.travis.yml

@@ -1,12 +1,15 @@
+dist: xenial
 language: ruby
 rvm:
-- 2.5.1
-- 2.6.2
+- 2.5
+- 2.6
+cache: bundler
+addons:
+  apt:
+    packages:
+    - libsodium-dev
 before_install:
-  - sudo add-apt-repository -y ppa:chris-lea/libsodium
-  - sudo apt-get -y update
-  - sudo apt-get install -y libsodium-dev
-  - gem update bundler
+  - gem update --system && gem install --no-document bundler
 script: bundle exec rake travis
 notifications:
   slack:

data/CHANGELOG.md

@@ -6,13 +6,28 @@ file.  This project adheres to [Semantic Versioning](http://semver.org/).
 As this project is pre 1.0, breaking changes may happen for minor version
 bumps.  A breaking change will get clearly notified in this log.
 
-## [0.19.0](https://github.com/stellar/ruby-stellar-base/compare/v0.17.0...master)
+## [0.20.0](https://github.com/stellar/ruby-stellar-base/compare/v0.19.0...master) - 2019-05-22
+### Added
+- Stellar Protocol 11 compatibility (#48)
+  - XDR changes for [CAP-0006 Buy Offers](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0006.md)
+  - XDR changes for [CAP-0020 Bucket Initial Entries](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0020.md)
+  - Add `manage_buy_offer`, `manage_sell_offer` and `create_passive_sell_offer` factory methods to `Stellar::Transaction` and `Stellar::Operation`
+
+### Changed
+- Deprecate `manage_offer` and `create_passive_offer` factory methods in `Stellar::Transaction` and `Stellar::Operation`
+- Add an option to pass the exact stellar-core revision into `xdr:update` Rake task 
+
+## [0.19.0](https://github.com/stellar/ruby-stellar-base/compare/v0.18.0...v0.19.0)
+### Changed
+- Loosen ActiveSupport to >= 5.0.0
+
+## [0.18.0](https://github.com/stellar/ruby-stellar-base/compare/v0.17.0...v0.18.0)
 ### Added
 - Update XDR definitions for stellar-core v10.0.0 (introduces Liabilities and other changes to support asset-backed offers as per [CAP-0003 Specification](https://github.com/stellar/stellar-protocol/blob/master/core/cap-0003.md#specification))
+- Add factories for ledger, transaction, operation.
 
 ### Changed
 - Use rbnacl instead of rbnacl-libsodium (the latter has been [deprecated](https://github.com/crypto-rb/rbnacl-libsodium/issues/29))
-- Loosen ActiveSupport to >= 5.0.0
 
 ## [0.17.0](https://github.com/stellar/ruby-stellar-base/compare/v0.16.0...v0.17.0)
 ### Fixed

data/examples/allow_trust.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+
+require 'rest-client'
+require 'stellar-base'
+
+# This is an example of using a higher level allow_trust operation.
+# This assumes that a stellar account is already created and a trustline
+# to an anchor's asset has been established.
+
+HUG_ASSET_CODE = 'HUG'
+
+def sequence_from_account(account)
+  data = get_account_data(account)
+  data['sequence'].to_i
+end
+
+def get_account_data(keypair, network_url)
+  response = RestClient.get "#{network_url}/accounts/#{keypair.address}"
+  JSON.parse(response.body)
+end
+
+def submit_transaction_operation(xdr_envelope, network_url)
+  begin
+    response = RestClient.post "#{network_url}/transactions", { tx: xdr_envelope }
+    JSON.parse(response.body)
+
+  rescue RestClient::ExceptionWithResponse => e
+    # handle exceptions here
+  end
+end
+
+def allow_trust(address, issuer_keypair)
+  account = Stellar::KeyPair.from_address(address)
+  current_sequence = sequence_from_account(issuer_keypair)
+
+  tx = Stellar::Transaction.allow_trust({
+    trustor: account,
+    account: issuer_keypair,
+    asset: [:alphanum4, HUG_ASSET_CODE, issuer_keypair],
+    authorize: true,
+    sequence:  current_sequence + 1, 
+  })
+
+  xdr_envelope = tx.to_envelope(issuer_keypair).to_xdr(:base64)
+  submit_transaction_operation(xdr_envelope)
+end
+
+# Usage: 
+# issuer_keypair must be a keypair from an anchor with both the public and
+# private key i.e type Stellar::KeyPair
+allow_trust("GCHOWITWOUNRUXGJWYUB4IMICZKROLHDRC2TJH5W324LBJVM4JUVXOZL", issuer_keypair)

data/generated/stellar-base-generated.rb

@@ -33,7 +33,10 @@ module Stellar
   String32 = XDR::String[32]
   String64 = XDR::String[64]
   SequenceNumber = Int64
+  TimePoint = Uint64
   DataValue = XDR::VarOpaque[64]
+  AssetCode4 = XDR::Opaque[4]
+  AssetCode12 = XDR::Opaque[12]
   autoload :AssetType
   autoload :Asset
   autoload :Price
@@ -62,8 +65,9 @@ module Stellar
   autoload :CreateAccountOp
   autoload :PaymentOp
   autoload :PathPaymentOp
-  autoload :ManageOfferOp
-  autoload :CreatePassiveOfferOp
+  autoload :ManageSellOfferOp
+  autoload :ManageBuyOfferOp
+  autoload :CreatePassiveSellOfferOp
   autoload :SetOptionsOp
   autoload :ChangeTrustOp
   autoload :AllowTrustOp
@@ -73,6 +77,7 @@ module Stellar
   autoload :MemoType
   autoload :Memo
   autoload :TimeBounds
+  MAX_OPS_PER_TX = 100
   autoload :Transaction
   autoload :TransactionSignaturePayload
   autoload :TransactionEnvelope
@@ -84,10 +89,12 @@ module Stellar
   autoload :PathPaymentResultCode
   autoload :SimplePaymentResult
   autoload :PathPaymentResult
-  autoload :ManageOfferResultCode
+  autoload :ManageSellOfferResultCode
   autoload :ManageOfferEffect
   autoload :ManageOfferSuccessResult
-  autoload :ManageOfferResult
+  autoload :ManageSellOfferResult
+  autoload :ManageBuyOfferResultCode
+  autoload :ManageBuyOfferResult
   autoload :SetOptionsResultCode
   autoload :SetOptionsResult
   autoload :ChangeTrustResultCode
@@ -112,12 +119,15 @@ module Stellar
   include XDR::Namespace
 
   UpgradeType = XDR::VarOpaque[128]
+  autoload :StellarValueType
+  autoload :LedgerCloseValueSignature
   autoload :StellarValue
   autoload :LedgerHeader
   autoload :LedgerUpgradeType
   autoload :LedgerUpgrade
   autoload :LedgerKey
   autoload :BucketEntryType
+  autoload :BucketMetadata
   autoload :BucketEntry
   autoload :TransactionSet
   autoload :TransactionResultPair

data/generated/stellar/allow_trust_op.rb

@@ -12,10 +12,10 @@ require 'xdr'
 #       {
 #       // ASSET_TYPE_NATIVE is not allowed
 #       case ASSET_TYPE_CREDIT_ALPHANUM4:
-#           opaque assetCode4[4];
+#           AssetCode4 assetCode4;
 #   
 #       case ASSET_TYPE_CREDIT_ALPHANUM12:
-#           opaque assetCode12[12];
+#           AssetCode12 assetCode12;
 #   
 #           // add other asset types here in the future
 #       }

data/generated/stellar/allow_trust_op/asset.rb

@@ -9,10 +9,10 @@ require 'xdr'
 #       {
 #       // ASSET_TYPE_NATIVE is not allowed
 #       case ASSET_TYPE_CREDIT_ALPHANUM4:
-#           opaque assetCode4[4];
+#           AssetCode4 assetCode4;
 #   
 #       case ASSET_TYPE_CREDIT_ALPHANUM12:
-#           opaque assetCode12[12];
+#           AssetCode12 assetCode12;
 #   
 #           // add other asset types here in the future
 #       }
@@ -26,8 +26,8 @@ module Stellar
       switch :asset_type_credit_alphanum4,  :asset_code4
       switch :asset_type_credit_alphanum12, :asset_code12
 
-      attribute :asset_code4,  XDR::Opaque[4]
-      attribute :asset_code12, XDR::Opaque[12]
+      attribute :asset_code4,  AssetCode4
+      attribute :asset_code12, AssetCode12
     end
   end
 end

data/generated/stellar/asset.rb

@@ -13,14 +13,14 @@ require 'xdr'
 #   case ASSET_TYPE_CREDIT_ALPHANUM4:
 #       struct
 #       {
-#           opaque assetCode[4]; // 1 to 4 characters
+#           AssetCode4 assetCode;
 #           AccountID issuer;
 #       } alphaNum4;
 #   
 #   case ASSET_TYPE_CREDIT_ALPHANUM12:
 #       struct
 #       {
-#           opaque assetCode[12]; // 5 to 12 characters
+#           AssetCode12 assetCode;
 #           AccountID issuer;
 #       } alphaNum12;
 #   

data/generated/stellar/asset/alpha_num12.rb

@@ -7,7 +7,7 @@ require 'xdr'
 #
 #   struct
 #       {
-#           opaque assetCode[12]; // 5 to 12 characters
+#           AssetCode12 assetCode;
 #           AccountID issuer;
 #       }
 #
@@ -15,7 +15,7 @@ require 'xdr'
 module Stellar
   class Asset
     class AlphaNum12 < XDR::Struct
-      attribute :asset_code, XDR::Opaque[12]
+      attribute :asset_code, AssetCode12
       attribute :issuer,     AccountID
     end
   end

data/generated/stellar/asset/alpha_num4.rb

@@ -7,7 +7,7 @@ require 'xdr'
 #
 #   struct
 #       {
-#           opaque assetCode[4]; // 1 to 4 characters
+#           AssetCode4 assetCode;
 #           AccountID issuer;
 #       }
 #
@@ -15,7 +15,7 @@ require 'xdr'
 module Stellar
   class Asset
     class AlphaNum4 < XDR::Struct
-      attribute :asset_code, XDR::Opaque[4]
+      attribute :asset_code, AssetCode4
       attribute :issuer,     AccountID
     end
   end

data/generated/stellar/bucket_entry.rb

@@ -8,10 +8,13 @@ require 'xdr'
 #   union BucketEntry switch (BucketEntryType type)
 #   {
 #   case LIVEENTRY:
+#   case INITENTRY:
 #       LedgerEntry liveEntry;
 #   
 #   case DEADENTRY:
 #       LedgerKey deadEntry;
+#   case METAENTRY:
+#       BucketMetadata metaEntry;
 #   };
 #
 # ===========================================================================
@@ -20,9 +23,12 @@ module Stellar
     switch_on BucketEntryType, :type
 
     switch :liveentry, :live_entry
+    switch :initentry, :live_entry
     switch :deadentry, :dead_entry
+    switch :metaentry, :meta_entry
 
     attribute :live_entry, LedgerEntry
     attribute :dead_entry, LedgerKey
+    attribute :meta_entry, BucketMetadata
   end
 end

data/generated/stellar/bucket_entry_type.rb

@@ -7,15 +7,21 @@ require 'xdr'
 #
 #   enum BucketEntryType
 #   {
-#       LIVEENTRY = 0,
-#       DEADENTRY = 1
+#       METAENTRY =
+#           -1, // At-and-after protocol 11: bucket metadata, should come first.
+#       LIVEENTRY = 0, // Before protocol 11: created-or-updated;
+#                      // At-and-after protocol 11: only updated.
+#       DEADENTRY = 1,
+#       INITENTRY = 2 // At-and-after protocol 11: only created.
 #   };
 #
 # ===========================================================================
 module Stellar
   class BucketEntryType < XDR::Enum
+    member :metaentry, -1
     member :liveentry, 0
     member :deadentry, 1
+    member :initentry, 2
 
     seal
   end

data/generated/stellar/bucket_metadata.rb

@@ -0,0 +1,32 @@
+# This code was automatically generated using xdrgen
+# DO NOT EDIT or your changes may be overwritten
+
+require 'xdr'
+
+# === xdr source ============================================================
+#
+#   struct BucketMetadata
+#   {
+#       // Indicates the protocol version used to create / merge this bucket.
+#       uint32 ledgerVersion;
+#   
+#       // reserved for future use
+#       union switch (int v)
+#       {
+#       case 0:
+#           void;
+#       }
+#       ext;
+#   };
+#
+# ===========================================================================
+module Stellar
+  class BucketMetadata < XDR::Struct
+    include XDR::Namespace
+
+    autoload :Ext
+
+    attribute :ledger_version, Uint32
+    attribute :ext,            Ext
+  end
+end

data/generated/stellar/bucket_metadata/ext.rb

@@ -0,0 +1,24 @@
+# This code was automatically generated using xdrgen
+# DO NOT EDIT or your changes may be overwritten
+
+require 'xdr'
+
+# === xdr source ============================================================
+#
+#   union switch (int v)
+#       {
+#       case 0:
+#           void;
+#       }
+#
+# ===========================================================================
+module Stellar
+  class BucketMetadata
+    class Ext < XDR::Union
+      switch_on XDR::Int, :v
+
+      switch 0
+
+    end
+  end
+end

data/generated/stellar/change_trust_result_code.rb

@@ -16,7 +16,7 @@ require 'xdr'
 #                                        // cannot create with a limit of 0
 #       CHANGE_TRUST_LOW_RESERVE =
 #           -4, // not enough funds to create a new trust line,
-#       CHANGE_TRUST_SELF_NOT_ALLOWED = -5 // trusting self is not allowed
+#       CHANGE_TRUST_SELF_NOT_ALLOWED = -5  // trusting self is not allowed
 #   };
 #
 # ===========================================================================

data/generated/stellar/claim_offer_atom.rb

@@ -9,7 +9,7 @@ require 'xdr'
 #   {
 #       // emitted to identify the offer
 #       AccountID sellerID; // Account that owns the offer
-#       uint64 offerID;
+#       int64 offerID;
 #   
 #       // amount and asset taken from the owner
 #       Asset assetSold;
@@ -24,7 +24,7 @@ require 'xdr'
 module Stellar
   class ClaimOfferAtom < XDR::Struct
     attribute :seller_id,     AccountID
-    attribute :offer_id,      Uint64
+    attribute :offer_id,      Int64
     attribute :asset_sold,    Asset
     attribute :amount_sold,   Int64
     attribute :asset_bought,  Asset

data/generated/stellar/{create_passive_offer_op.rb → create_passive_sell_offer_op.rb}

@@ -5,7 +5,7 @@ require 'xdr'
 
 # === xdr source ============================================================
 #
-#   struct CreatePassiveOfferOp
+#   struct CreatePassiveSellOfferOp
 #   {
 #       Asset selling; // A
 #       Asset buying;  // B
@@ -15,7 +15,7 @@ require 'xdr'
 #
 # ===========================================================================
 module Stellar
-  class CreatePassiveOfferOp < XDR::Struct
+  class CreatePassiveSellOfferOp < XDR::Struct
     attribute :selling, Asset
     attribute :buying,  Asset
     attribute :amount,  Int64

data/generated/stellar/envelope_type.rb

@@ -9,15 +9,17 @@ require 'xdr'
 #   {
 #       ENVELOPE_TYPE_SCP = 1,
 #       ENVELOPE_TYPE_TX = 2,
-#       ENVELOPE_TYPE_AUTH = 3
+#       ENVELOPE_TYPE_AUTH = 3,
+#       ENVELOPE_TYPE_SCPVALUE = 4
 #   };
 #
 # ===========================================================================
 module Stellar
   class EnvelopeType < XDR::Enum
-    member :envelope_type_scp,  1
-    member :envelope_type_tx,   2
-    member :envelope_type_auth, 3
+    member :envelope_type_scp,      1
+    member :envelope_type_tx,       2
+    member :envelope_type_auth,     3
+    member :envelope_type_scpvalue, 4
 
     seal
   end