tangany 0.0.1

data/lib/tangany/customers/contracts/customers/list.rb

@@ -0,0 +1,17 @@
+module Tangany
+  module Customers
+    module Contracts
+      module Customers
+        class List < ApplicationContract
+          schema do
+            config.validate_keys = true
+
+            optional(:pageToken).maybe(:string)
+            optional(:limit).filled(:integer, gteq?: 1, lteq?: 100)
+            optional(:sort).filled(:string, included_in?: ALLOWED_SORTS)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/customers/update.rb

@@ -0,0 +1,14 @@
+require_relative "create"
+require_relative "update_schemas/customer"
+
+module Tangany
+  module Customers
+    module Contracts
+      module Customers
+        class Update < Create
+          schema(UpdateSchemas::Customer.schema) { config.validate_keys = true }
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/customers/update_schemas/customer.rb

@@ -0,0 +1,15 @@
+require_relative "../create_schemas/customer"
+
+module Tangany
+  module Customers
+    module Contracts
+      module Customers
+        module UpdateSchemas
+          module Customer
+            include CreateSchemas::Customer
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/customers.rb

@@ -0,0 +1,3 @@
+require_relative "customers/create"
+require_relative "customers/list"
+require_relative "customers/update"

data/lib/tangany/customers/contracts/natural_persons/create.rb

@@ -0,0 +1,23 @@
+require_relative "create_schemas/natural_person"
+
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        class Create < ApplicationContract
+          schema(CreateSchemas::NaturalPerson.schema) { config.validate_keys = true }
+
+          rule(pep: :source) do
+            key.failure("must be present if pep.isExposed is true") if values.dig(:pep, :isExposed) && !value
+            key.failure("must not be present if pep.isExposed is false") if !values.dig(:pep, :isExposed) && value
+          end
+
+          rule(sanctions: :source) do
+            key.failure("must be present if sanctions.isSanctioned is true") if values.dig(:sanctions, :isSanctioned) && !value
+            key.failure("must not be present if sanctions.isSanctioned is false") if !values.dig(:sanctions, :isSanctioned) && value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/create_schemas/address.rb

@@ -0,0 +1,23 @@
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module CreateSchemas
+          module Address
+            class << self
+              def schema
+                Dry::Schema.Params do
+                  required(:country).filled(:string, format?: Tangany::ApplicationContract::COUNTRY_CODE_REGEX)
+                  required(:city).filled(:string, max_size?: 255)
+                  required(:postcode).filled(:string, max_size?: 255)
+                  required(:streetName).filled(:string, max_size?: 255)
+                  required(:streetNumber).filled(:string, max_size?: 255)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/create_schemas/document.rb

@@ -0,0 +1,25 @@
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module CreateSchemas
+          module Document
+            class << self
+              def schema
+                Dry::Schema.Params do
+                  required(:country).filled(:string, format?: Tangany::ApplicationContract::COUNTRY_CODE_REGEX)
+                  required(:nationality).filled(:string, format?: Tangany::ApplicationContract::COUNTRY_CODE_REGEX)
+                  required(:number).filled(:string, max_size?: 255)
+                  required(:issuedBy).filled(:string, max_size?: 255)
+                  required(:issueDate).filled(:string, format?: Tangany::ApplicationContract::DATE_REGEX)
+                  required(:validUntil).filled(:string, format?: Tangany::ApplicationContract::DATE_REGEX)
+                  required(:type).filled(:string, included_in?: Tangany::Customers::Document::ALLOWED_TYPES)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/create_schemas/kyc.rb

@@ -0,0 +1,24 @@
+require_relative "document"
+
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module CreateSchemas
+          module Kyc
+            class << self
+              def schema
+                Dry::Schema.Params do
+                  required(:id).filled(:string, max_size?: 255)
+                  required(:date).filled(:string, format?: Tangany::ApplicationContract::DATE_REGEX)
+                  required(:method).filled(:string, included_in?: Tangany::Customers::Kyc::ALLOWED_METHODS)
+                  optional(:document).hash(Document.schema)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/create_schemas/natural_person.rb

@@ -0,0 +1,44 @@
+require_relative "address"
+require_relative "kyc"
+require_relative "pep"
+require_relative "sanctions"
+
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module CreateSchemas
+          module NaturalPerson
+            module ClassMethods
+              def schema
+                Dry::Schema.Params do
+                  required(:id).filled(:string, max_size?: 40)
+                  optional(:title).maybe(:string, max_size?: 255)
+                  required(:firstName).filled(:string, max_size?: 255)
+                  required(:lastName).filled(:string, max_size?: 255)
+                  optional(:gender).maybe(:string, included_in?: Tangany::Customers::NaturalPerson::ALLOWED_GENDERS)
+                  required(:birthDate).filled(:string, format?: Tangany::ApplicationContract::DATE_REGEX)
+                  required(:birthPlace).filled(:string, max_size?: 255)
+                  required(:birthCountry).filled(:string, format?: Tangany::ApplicationContract::COUNTRY_CODE_REGEX)
+                  optional(:birthName).maybe(:string, max_size?: 255)
+                  optional(:nationality).maybe(:string, format?: Tangany::ApplicationContract::COUNTRY_CODE_REGEX)
+                  optional(:address).hash(Address.schema)
+                  optional(:email).maybe(:string, max_size?: 255)
+                  optional(:kyc).hash(Kyc.schema)
+                  optional(:pep).hash(Pep.schema)
+                  optional(:sanctions).hash(Sanctions.schema)
+                end
+              end
+            end
+
+            extend ClassMethods
+
+            def self.included(base)
+              base.extend(ClassMethods)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/create_schemas/pep.rb

@@ -0,0 +1,22 @@
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module CreateSchemas
+          module Pep
+            class << self
+              def schema
+                Dry::Schema.Params do
+                  required(:checkDate).filled(:string, format?: Tangany::ApplicationContract::DATETIME_REGEX)
+                  required(:isExposed).filled(:bool)
+                  optional(:source).maybe(:string, max_size?: 255)
+                  optional(:reason).maybe(:string, max_size?: 255)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/create_schemas/sanctions.rb

@@ -0,0 +1,22 @@
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module CreateSchemas
+          module Sanctions
+            class << self
+              def schema
+                Dry::Schema.Params do
+                  required(:checkDate).filled(:string, format?: Tangany::ApplicationContract::DATETIME_REGEX)
+                  required(:isSanctioned).filled(:bool)
+                  optional(:source).maybe(:string, max_size?: 255)
+                  optional(:reason).maybe(:string, max_size?: 255)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/list.rb

@@ -0,0 +1,17 @@
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        class List < ApplicationContract
+          schema do
+            config.validate_keys = true
+
+            optional(:pageToken).maybe(:string)
+            optional(:limit).filled(:integer, gteq?: 1, lteq?: 100)
+            optional(:sort).filled(:string, included_in?: ALLOWED_SORTS)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/update.rb

@@ -0,0 +1,14 @@
+require_relative "create"
+require_relative "update_schemas/natural_person"
+
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        class Update < Create
+          schema(UpdateSchemas::NaturalPerson.schema) { config.validate_keys = true }
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons/update_schemas/natural_person.rb

@@ -0,0 +1,15 @@
+require_relative "../create_schemas/natural_person"
+
+module Tangany
+  module Customers
+    module Contracts
+      module NaturalPersons
+        module UpdateSchemas
+          module NaturalPerson
+            include CreateSchemas::NaturalPerson
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/natural_persons.rb

@@ -0,0 +1,3 @@
+require_relative "natural_persons/create"
+require_relative "natural_persons/list"
+require_relative "natural_persons/update"

data/lib/tangany/customers/contracts/wallet_links/create.rb

@@ -0,0 +1,28 @@
+module Tangany
+  module Customers
+    module Contracts
+      module WalletLinks
+        class Create < ApplicationContract
+          ALLOWED_TYPES = ["waas"].freeze
+
+          schema do
+            config.validate_keys = true
+
+            required(:id).filled(:string, max_size?: 40)
+            optional(:address).filled(:string, format?: ApplicationContract::ETHEREUM_ADDRESS_REGEX)
+            optional(:wallet).filled(:string)
+            required(:assetId).filled(:string, included_in?: Tangany::Customers::WalletLink::ALLOWED_CHAIN_IDS)
+            optional(:assignment).hash do
+              required(:customerId).filled(:string)
+            end
+          end
+
+          rule do
+            key.failure("one ne of address or wallet must be present") if !values[:address] && !values[:wallet]
+            key.failure("only one of address or wallet must be present") if values[:address] && values[:wallet]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/wallet_links/list.rb

@@ -0,0 +1,17 @@
+module Tangany
+  module Customers
+    module Contracts
+      module WalletLinks
+        class List < ApplicationContract
+          schema do
+            config.validate_keys = true
+
+            optional(:limit).filled(:integer, gt?: 0, lteq?: 100)
+            optional(:sort).filled(:string, included_in?: ALLOWED_SORTS)
+            optional(:pageToken).maybe(:string)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tangany/customers/contracts/wallet_links.rb

@@ -0,0 +1,2 @@
+require_relative "wallet_links/create"
+require_relative "wallet_links/list"

data/lib/tangany/customers/contracts.rb

@@ -0,0 +1,3 @@
+require_relative "contracts/customers"
+require_relative "contracts/natural_persons"
+require_relative "contracts/wallet_links"

data/lib/tangany/customers/objects/address.rb

@@ -0,0 +1,11 @@
+module Tangany
+  module Customers
+    class Address < Object
+      attribute :country, Types::String
+      attribute :city, Types::String
+      attribute :postcode, Types::String
+      attribute :streetName, Types::String
+      attribute :streetNumber, Types::String
+    end
+  end
+end

data/lib/tangany/customers/objects/contract.rb

@@ -0,0 +1,13 @@
+module Tangany
+  module Customers
+    class Contract < Object
+      ALLOWED_TYPES = %w[standard].freeze
+
+      attribute :type, Types::String
+      attribute :signedDate, Types::Date
+      attribute? :cancelledDate, Types::Date.optional
+
+      to_date :signedDate, :cancelledDate
+    end
+  end
+end

data/lib/tangany/customers/objects/customer.rb

@@ -0,0 +1,14 @@
+module Tangany
+  module Customers
+    class Customer < Object
+      attribute :id, Types::String
+      attribute :owner do
+        attribute :entityId, Types::String
+      end
+      attribute :authorized, Types::Array do
+        attribute :entityId, Types::String
+      end
+      attribute :contracts, Types::Array.of(Contract)
+    end
+  end
+end

data/lib/tangany/customers/objects/document.rb

@@ -0,0 +1,17 @@
+module Tangany
+  module Customers
+    class Document < Object
+      ALLOWED_TYPES = %w[id_card passport other].freeze
+
+      attribute :country, Types::String
+      attribute :nationality, Types::String
+      attribute :number, Types::String
+      attribute :issuedBy, Types::String
+      attribute :issueDate, Types::Date
+      attribute :validUntil, Types::Date
+      attribute :type, Types::String
+
+      to_date :issueDate, :validUntil
+    end
+  end
+end

data/lib/tangany/customers/objects/kyc.rb

@@ -0,0 +1,16 @@
+require_relative "document"
+
+module Tangany
+  module Customers
+    class Kyc < Object
+      ALLOWED_METHODS = %w[video_ident id_copy auto_ident in_person].freeze
+
+      attribute :id, Types::String
+      attribute :date, Types::DateTime
+      attribute :method, Types::String
+      attribute? :document, Document
+
+      to_datetime :date
+    end
+  end
+end

data/lib/tangany/customers/objects/natural_person.rb

@@ -0,0 +1,30 @@
+require_relative "address"
+require_relative "kyc"
+require_relative "pep"
+require_relative "sanctions"
+
+module Tangany
+  module Customers
+    class NaturalPerson < Object
+      ALLOWED_GENDERS = %w[F M X].freeze
+
+      attribute :id, Types::String
+      attribute? :title, Types::String.optional
+      attribute :firstName, Types::String
+      attribute :lastName, Types::String
+      attribute? :gender, Types::String.optional
+      attribute :birthDate, Types::Date
+      attribute :birthPlace, Types::String
+      attribute :birthCountry, Types::String
+      attribute? :birthName, Types::String.optional
+      attribute? :nationality, Types::String.optional
+      attribute? :address, Address
+      attribute? :email, Types::String.optional
+      attribute? :kyc, Kyc
+      attribute? :pep, Pep
+      attribute? :sanctions, Sanctions
+
+      to_date :birthDate
+    end
+  end
+end

data/lib/tangany/customers/objects/pep.rb

@@ -0,0 +1,12 @@
+module Tangany
+  module Customers
+    class Pep < Object
+      attribute :checkDate, Types::DateTime
+      attribute :isExposed, Types::Bool
+      attribute? :source, Types::String.optional
+      attribute? :reason, Types::String.optional
+
+      to_datetime :checkDate
+    end
+  end
+end

data/lib/tangany/customers/objects/sanctions.rb

@@ -0,0 +1,12 @@
+module Tangany
+  module Customers
+    class Sanctions < Object
+      attribute :checkDate, Types::DateTime
+      attribute :isSanctioned, Types::Bool
+      attribute? :source, Types::String.optional
+      attribute? :reason, Types::String.optional
+
+      to_datetime :checkDate
+    end
+  end
+end

data/lib/tangany/customers/objects/wallet_link.rb

@@ -0,0 +1,14 @@
+module Tangany
+  module Customers
+    class WalletLink < Object
+      ALLOWED_CHAIN_IDS = Tangany.chains.map { |chain| chain["asset_id"] }.freeze
+
+      attribute :id, Types::String
+      attribute :address, Types::String
+      attribute :assetId, Types::String
+      attribute? :assignment do
+        attribute :customerId, Types::String
+      end
+    end
+  end
+end

data/lib/tangany/customers/objects.rb

@@ -0,0 +1,5 @@
+require_relative "objects/contract"
+require_relative "objects/natural_person"
+require_relative "objects/wallet_link"
+
+require_relative "objects/customer"

data/lib/tangany/customers/resource.rb

@@ -0,0 +1,11 @@
+module Tangany
+  module Customers
+    class Resource < Tangany::Resource
+      private
+
+      def default_headers
+        {"tangany-subscription" => client.subscription}
+      end
+    end
+  end
+end

data/lib/tangany/customers/resources/customers_resource.rb

@@ -0,0 +1,27 @@
+module Tangany
+  module Customers
+    class CustomersResource < Resource
+      BASE_PATH = "customers"
+
+      def create(**params)
+        Customer.new(post_request(BASE_PATH, body: sanitize_params!(params).to_json).body)
+      end
+
+      def delete(customer_id)
+        delete_request("#{BASE_PATH}/#{customer_id}")
+      end
+
+      def list(**params)
+        Collection.from_response(get_request(BASE_PATH, params: sanitize_params!(params)), type: Customer)
+      end
+
+      def retrieve(customer_id)
+        Customer.new(get_request("#{BASE_PATH}/#{customer_id}").body)
+      end
+
+      def update(customer_id, **params)
+        Customer.new(put_request("#{BASE_PATH}/#{customer_id}", body: sanitize_params!(params).to_json).body)
+      end
+    end
+  end
+end

data/lib/tangany/customers/resources/natural_persons_resource.rb

@@ -0,0 +1,26 @@
+module Tangany
+  module Customers
+    class NaturalPersonsResource < Resource
+      BASE_PATH = "entities/natural-persons"
+      def create(**params)
+        NaturalPerson.new(post_request(BASE_PATH, body: sanitize_params!(params).to_json).body)
+      end
+
+      def delete(entity_id)
+        delete_request("#{BASE_PATH}/#{entity_id}")
+      end
+
+      def list(**params)
+        Collection.from_response(get_request(BASE_PATH, params: sanitize_params!(params)), type: NaturalPerson)
+      end
+
+      def retrieve(entity_id)
+        NaturalPerson.new(get_request("#{BASE_PATH}/#{entity_id}").body)
+      end
+
+      def update(entity_id, **params)
+        NaturalPerson.new(put_request("#{BASE_PATH}/#{entity_id}", body: sanitize_params!(params).to_json).body)
+      end
+    end
+  end
+end

data/lib/tangany/customers/resources/wallet_links_resource.rb

@@ -0,0 +1,37 @@
+module Tangany
+  module Customers
+    class WalletLinksResource < Resource
+      BASE_PATH = "wallet-links"
+
+      def create(**params)
+        contract_hash = sanitize_params!(params)
+        WalletLink.new(post_request(BASE_PATH, body: prepare_create_hash(contract_hash).to_json).body)
+      end
+
+      def delete(wallet_link_id)
+        delete_request("#{BASE_PATH}/#{wallet_link_id}")
+      end
+
+      def list(**params)
+        Collection.from_response(get_request(BASE_PATH, params: sanitize_params!(params)), type: WalletLink)
+      end
+
+      def retrieve(wallet_link_id)
+        WalletLink.new(get_request("#{BASE_PATH}/#{wallet_link_id}").body)
+      end
+
+      private
+
+      def prepare_create_hash(hash)
+        # TODO: derive wallet address from secp256k1 public key instead of using the Custody API
+        if hash[:wallet]
+          custody_client = Tangany::Custody::Client.new
+          wallet_status = custody_client.wallet_statuses(asset_id: hash[:assetId]).retrieve(hash[:wallet])
+          hash[:address] = wallet_status.address
+          hash.delete(:wallet)
+        end
+        hash
+      end
+    end
+  end
+end

data/lib/tangany/customers/resources.rb

@@ -0,0 +1,3 @@
+require_relative "resources/customers_resource"
+require_relative "resources/natural_persons_resource"
+require_relative "resources/wallet_links_resource"

data/lib/tangany/customers.rb

@@ -0,0 +1,8 @@
+require_relative "customers/application_contract"
+require_relative "customers/client"
+require_relative "customers/collection"
+require_relative "customers/objects"
+require_relative "customers/resource"
+
+require_relative "customers/contracts"
+require_relative "customers/resources"