{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This document defines the interfaces exposed by FinP2P-Network. The interface is implemented as a set of gRPC services with the respective protobuf3 messages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Implementation of FinP2P Network MUST comply with this specification and supports ALL the mandatory services and functions.","type":"text"}]},{"type":"paragraph","content":[{"text":"These interfaces are designed to create an abstraction layer between FinP2P Network and FinP2P Core.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Table of Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"exclude":{"value":"Table of Contents"}},"macroMetadata":{"macroId":{"value":"2127faf4-8178-45e4-aad9-6990d5a71a76"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"b889d615-79f4-4ef5-b2e6-cfb201631536"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Interface Message Format","type":"text"}]},{"type":"paragraph","content":[{"text":"The protobuf3 messages defined in this section are the building blocks of the inter FinP2P Router communication.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Terminology","type":"text"}]},{"type":"paragraph","content":[{"text":"Definition of terms used in the spec","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"FinID Token","type":"text"}]},{"type":"paragraph","content":[{"text":"The FinID token is a JWT generated by a Governance Router. It provides proof that the owner Router identity was verified and certified by the Governance Router.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Token includes critical Router information that is used and validated during FinP2P protocol. This information is signed by the Governance Router.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Token Claims","type":"text"}]},{"type":"paragraph","content":[{"text":"As part of the claims, this token includes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cluster ID. the cluster ID for this Organization ID. And Organization can belong to different cluster. For each cluster, an organization registers a different, system wide unique, Org ID.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Organization Public FinID. By adding the Organization FinID, we can always verify that the Router presenting the FinID Token is in fact the real owner of the token by verifying signatures.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Organization Information details: Name, email address, etc.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The JWT token must be signed by a Governance Router.","type":"text"}]},{"type":"codeBlock","content":[{"text":"header:{\n \"alg\": \"ES256\",\n \"kid\": < Id of the key used to sing this token >,\n \"typ\": \"JWT\"\n},\npayload:{\n // JWT Claims\n \"iss\": < Governance issuer >,\n // OrgID alwasy start witht he prefix \"ORG:\"\n \"sub\": < Org Resource ID >,\n \"aud\":[\"randezvous\", < others >],\n \"iat\": < time this token was generated >\n \"exp\": < Expiration Time for this FinID Token >,\n \"jti\": < FinID Token Unique Identifier >\n \n // FinID Token Claims\n // ClusterID always starts with the prefix \"CLR:\"\n \"clusterid\": < Cluster ID for this Org ID >,\n \"finid\":{\n },\n \"orginfo\":{\n \"createdAt\": < time this organization was created >\n \"name\": < Organization Name >,\n \"email\": < Organization Admin email address>,\n \n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ClusterID","type":"text"}]},{"type":"paragraph","content":[{"text":"This ID identifies a ","type":"text"},{"text":"Cluster","type":"text","marks":[{"type":"code"}]},{"text":" of FinP2P Routers. A ","type":"text"},{"text":"Cluster","type":"text","marks":[{"type":"code"}]},{"text":" is defined as a group of organizations sharing the same distributed ledger.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the following diagram we have 2 clusters: Cluster_A and Cluster_B:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":828,"id":"a35a6a0d-8522-4614-8d07-3af854054289","collection":"contentId-67764240","type":"file","height":400}}]},{"type":"paragraph","content":[{"text":"Organization 1, Organization 2 and Organization 3 belongs to Cluster_A, and Organization 3 and 4 belong to Cluster_B. In this example Organization_3 belong to more than one cluster.","type":"text"}]},{"type":"paragraph","content":[{"text":"The cluster ID has a prefix of CLR:, i.e.: ","type":"text"},{"text":"CLR:MyCluster1234","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ResourceID","type":"text"}]},{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"resource ID","type":"text","marks":[{"type":"code"}]},{"text":" identifies the resource type and its location. The location of a resource is defined as the location of the Organization managing that resource.","type":"text"}]},{"type":"paragraph","content":[{"text":"The hierarchy of a ","type":"text"},{"text":"resource ID","type":"text","marks":[{"type":"code"}]},{"text":" resembles a URI/URL to the exact location of the desired resource.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ResourceID format","type":"text"}]},{"type":"paragraph","content":[{"text":"::","type":"text"}]},{"type":"table","attrs":{"layout":"wide","width":960.0,"localId":"bff6a4fc-228c-44e1-bcfe-6c3aaa460cd7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[578.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[210.0]},"content":[{"type":"paragraph","content":[{"text":"Notes","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"organization id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[578.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier of the organization responsible to manage the resource","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[210.0]},"content":[{"type":"paragraph","content":[{"text":"An OrgID has always a prefix of ORG:,","type":"text"},{"type":"hardBreak"},{"text":"i.e. ","type":"text"},{"text":"ORG:MyOrgID","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"resource type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[578.0]},"content":[{"type":"paragraph","content":[{"text":"The type of the resource. Resource type is specified with an ID. The specification reserves the following IDs range:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0-99","type":"text","marks":[{"type":"strong"}]},{"text":": unused","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"100-999","type":"text","marks":[{"type":"strong"}]},{"text":": reserved for FinP2P","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1000- : ","type":"text","marks":[{"type":"strong"}]},{"text":"Undefined","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In this specification we define:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"101","type":"text","marks":[{"type":"strong"}]},{"text":": user. A resource identifying a user of the system","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"102","type":"text","marks":[{"type":"strong"}]},{"text":": asset. A resource identifying an asset.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[210.0]},"content":[{"type":"paragraph","content":[{"text":"If an Implementation wants to specify a resource not defined in this specification it must use the undefined range. Undefined range is not part of the specification but it may be monitored to avoid overlapping.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[578.0]},"content":[{"type":"paragraph","content":[{"text":"The id field is the internal identification of the resource. Organizations may have different methods to identify their resource.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[210.0]},"content":[{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ResourceID Proto3 Representation","type":"text"}]},{"type":"codeBlock","content":[{"text":"message ResourceID {\n string orgID = 1; // orgid always start with the prefix \"ORG:\"\n enum ResourceType {\n reserved 0 to 99;\n USER = 101;\n ASSET = 102;\n ESCROW_ACCOUNT = 103;\n SETTLEMENT_ASSET = 104;\n ASSET_TRANSACTION_INTENT = 105;\n reserved 106 to 999;\n }\n ResourceType type = 2;\n bytes resource = 3;\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Asset Transaction Signature Template (ATST)","type":"text"}]},{"type":"paragraph","content":[{"text":"Not all the clusters participating in the FinP2P network implements the same Distributed Ledger Technology (DLT) to record asset transactions. Therefore, the transaction signature requirements for each are different and specified by the particular DTL in place.","type":"text"}]},{"type":"paragraph","content":[{"text":"When Org A wants to transact with an asset managed by Org B, Org A must send a signed transaction that conforms with Org B’s underlying DLT specification. ","type":"text"},{"type":"hardBreak"},{"text":"We define the ","type":"text"},{"text":"Asset Transaction Signature Template","type":"text","marks":[{"type":"code"}]},{"text":" to provide a signature scheme that Organizations not sharing the same cluster can create complaint signature and messages.","type":"text"}]},{"type":"paragraph","content":[{"text":"In general, a signature is applied to the hash of the message that we want to transmit. The message is a concatenation of several fields in a particular order, with or without delimiters between them.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ATST v0.1","type":"text"}]},{"type":"paragraph","content":[{"text":"For this preliminary version we require that the ATST includes ONLY fields and field types that can be provided by the signing organization internally. Further revisions may include more sophisticated implementation of ATST such as libraries to do the actual calculation, or API’s definition to retrieve message values from the executing Organization.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message SignatureTemplate {\n repeated HashGroup hashGroups = 1;\n bytes hash = 2; // combined hash value of all hash groups\n}\n\nmessage HashGroup {\n bytes hash = 1;\n repeated HashField fields = 2;\n}\n\nmessage HashField {\n string name = 1;\n enum Type {\n UNKNOWN = 0;\n STRING = 1;\n INT = 2;\n BYTES = 3;\n }\n Type type = 2;\n bytes value = 3;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Supported types:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d7e74d9d-7768-45ef-87a0-6d033e640801"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Types","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Samples","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"UTF-8, UTF-16","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"INT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"int64","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"UID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"byte","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Network interface","type":"text"}]},{"type":"paragraph","content":[{"text":"This specification defines 2 logical layers that interacts with each other. The first Layer is FinP2P-Core where al the Business logic is implemented and services defined. the second Layer is FinP2P-Netowrk. this network layer is actually the layer that implements the gRPC protocol as specified in this document.","type":"text"}]},{"type":"paragraph","content":[{"text":"Different implementation can define the interface between those layers in several ways. With this specification we do not mandate any particular interface between the layer. The only requirements is to support the gRPC services with he defined messages","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Message Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The Request Message Structure defines the type of fields an gRPS request expects as input.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Message Structure proto3","type":"text"}]},{"type":"codeBlock","content":[{"text":"message { // The actual message name is defined per service\n Envelope envelope = 1;\n payload = 2; // Each service defines its request payload\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"If the services requires a signed Message a signed request is created:","type":"text"}]},{"type":"codeBlock","content":[{"text":"message { // The actual message name is defined per service\n Request request =1; // Original plain request\n Signature signature = 2; // The signature\n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Envelope","type":"text"}]},{"type":"paragraph","content":[{"text":"The envelope includes routing information. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Envelope {\n // request identifier\n string requestid = 1; //< random generated id > \n // this ID is generated by the sender and \n // returned by the responder.\n // It uniquely identify a request/response pair\n // routing\n string from = 2; // < sender Org id >\n string to = 3; // < recipient Org id / Cluster ID > \n // optional on Broadcast messages\n}","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note on the ","type":"text"},{"text":"To","type":"text","marks":[{"type":"strong"}]},{"text":" field:","type":"text"}]},{"type":"paragraph","content":[{"text":"On broadcast requests to the same cluster, the cluster ID must be specified. This will provide the FinP2P-Network a hint about the group of Routers to be addressed.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Balance task shows an example","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Payload","type":"text"}]},{"type":"paragraph","content":[{"text":"The payload of the message is defined by each service.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Signature","type":"text"}]},{"type":"paragraph","content":[{"text":"The signature field includes the cryptographic signature of the sender using its FinID private key. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The message to sign is defined as: sig_alg(hash(envelope, payload)). The result is stored in the ","type":"text"},{"text":"payload","type":"text","marks":[{"type":"code"}]},{"text":" field as a byte array.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Signature {\n Algorithm alg = 1;\n bytes payload = 3;\n}\n\nmessage Algorithm {\n string type = 1;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Algorithm","type":"text","marks":[{"type":"code"}]},{"text":" filed is used to represent other signature and hash combinations. The default for this specification is: ECDSA and SHA3-256","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Message Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Every message sent to the network, either P2P or Broadcast, eventually will produce a single response or multiple responses.","type":"text"}]},{"type":"paragraph","content":[{"text":"The response message has a common structure that is shared among all task, and a task custom section.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message { // The actual message name is defined per service\n Envelope envelope = 1;\n Status status = 2;\n payload = 3; // Each service defines the response payload\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"If the Response has to be signed a signed message is created:","type":"text"}]},{"type":"codeBlock","content":[{"text":"message { // The actual message name is defined per service\n Response response = 1;\n Signature signature = 2;\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Envelope","type":"text"}]},{"type":"paragraph","content":[{"text":"The envelope section is identical to the request ","type":"text"},{"text":"envelope","type":"text","marks":[{"type":"code"}]},{"text":" but the to and from are swapped. And in a broadcast request, the From is filled with the actual responder ID.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Envelope {\n // request identifier\n string requestid = 1; // Copy from request message \n // this ID is generated by the sender and \n // returned by the responder.\n // It uniquely identify a request/response pair\n // routing\n string from = 2; // The actual responder ( if the message was sent to )\n string to = 3; // This is the \"from\" from the request \n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Status","type":"text"}]},{"type":"paragraph","content":[{"text":"The status object notifies the receiver about the outcome of the request. Status code and message may have special meaning per each task.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this specification we define:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"829df08d-dd71-46c9-a53a-45f7dc842c53"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Notes","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"The request was handled successfully","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"1-999","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"An error has occurred.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"See task for error descriptions","type":"text"}]}]}]}]},{"type":"codeBlock","content":[{"text":"message Status: {\n uint32 code = 1; // A status code representing success|warning|error\n string message = 2; // message or sructure adding more information about the status code\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Payload","type":"text"}]},{"type":"paragraph","content":[{"text":"The payload is the response from the Organization taking the request. The payload format and structure is defined per task.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Signature","type":"text"}]},{"type":"paragraph","content":[{"text":"The signature section is the same as for the ","type":"text"},{"text":"request","type":"text","marks":[{"type":"code"}]},{"text":"message, but in this case the signer is the Organization responding to the request.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Signature {\n Algorithm alg = 1;\n bytes payload = 3;\n}\n\nmessage Algorithm {\n string type = 1;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The receiver can verify if the signature is valid by verifying it with the FinID of the response sender. The FinID can be retrieved using the Sender’s ( From field ) resourceID as the index.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: During advertising, Each Router advertise its resource ID and FinID ( see below ","type":"text"},{"text":"Advertise","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Accounts","type":"text"}]},{"type":"paragraph","content":[{"text":"Accounts are a way to represent various Accounts and Asset types which may be available on the FinP2P network (e.g. FinID account, Escrow account, FinP2P Asset) or may be available outside of the FinP2P network (e.g Fiat asset, Cryptocurrency assets, crypto wallet account), those models are used as part of the intent definition and execution to indicate which asset are expected to participate in the operation and where those asset are located.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Asset {\n enum Type {\n Unknown = 0;\n FinP2PAsset = 1;\n Fiat = 2;\n Cryptocurrency = 3;\n }\n string code = 1; // code uniquely identifying the asset (e.g ISO-4217 for Fiat type, ResourceID for FinP2PAsset etc..)\n Type assetType = 2;\n}\n\n// Account is composed of an asset which is backed by in the account\n// and account unique identifier for that type of account\nmessage Account {\n Asset asset = 1;\n AccountIdentifier identifier = 2;\n}\n\nmessage AccountIdentifier {\n oneof identifier {\n CryptocurrencyWallet wallet = 1;\n Iban account = 2;\n common.FinID finId = 3;\n Escrow escrowAccount = 4;\n }\n}\n\nmessage CryptocurrencyWallet {\n bytes address = 1;\n}\n\nmessage Iban {\n string code = 1;\n}\n\nmessage Escrow {\n common.ResourceID escrowAccount = 1;\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Service specifications","type":"text"}]},{"type":"paragraph","content":[{"text":"Services are the function defined on the messages FinP2P-Network shares with other Routers.","type":"text"}]},{"type":"paragraph","content":[{"text":"Following ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://finp2p.atlassian.net/wiki/spaces/FINP2P/pages/1043628037"}},{"text":" for detailed description about the network functional services.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Advertise Service","type":"text"}]},{"type":"paragraph","content":[{"text":"A Router use this task to advertise to the network the Router capabilities, supported resources, new address, etc","type":"text"}]},{"type":"paragraph","content":[{"text":"The Advertise message has always the ","type":"text"},{"text":"Rendezvous","type":"text","marks":[{"type":"code"}]},{"text":" cluster as destination. Other FinP2P Routers may also be targeted.","type":"text"}]},{"type":"codeBlock","content":[{"text":"service AdvertiseService {\n rpc Advertise(SignedAdvertiseRequest) returns (SignedAdvertiseResponse) {}\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Message","type":"text"}]},{"type":"paragraph","content":[{"text":"The advertisement packet includes multiple units that can be sent one by one or all in a single packet. The only required field is the Identity field.","type":"text"}]},{"type":"paragraph","content":[{"text":"At any time a FinP2P Router can send this packet to update its information.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message AdvertisementRequest {\n Enveloper envelope = 1;\n AdvertisementPayload payload = 2;\n}\nmessage AdvertisementPayload {\n FinIDToken token= 1; // Required\n repeated Address address = 2;\n repeated Resources resources = 3;\n repeated Capability capability = 4;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Every advertisement message includes the Organization FinID Token:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Common","type":"text"}]},{"type":"codeBlock","content":[{"text":"message FinIDToken {\n bytes token = 1; // Serialized FinID JWT\n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address","type":"text"}]},{"type":"paragraph","content":[{"text":"Network Address of this Router. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Address {\n string address = 1; // ip address | name // Name is a DNS resolvable name\n uint32 port = 2; // listen port\n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Resources","type":"text"}]},{"type":"paragraph","content":[{"text":"A FinP2P Router advertise its resources with an initial ACL list. This ACL list is used to protect the visibility of the resources and allow only Organizations on the ACL to be able to read.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message ACL {\n repeated ResourceID resources = 1; // List of Org ID that can access a resource.\n}\n\nmessage Resource {\n ACL acl = 1\n RecourceID resource = 2; // Advertised resource.\n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Capabilities","type":"text"}]},{"type":"paragraph","content":[{"text":"The capability structure enumerate the supported capabilities of this Router.","type":"text"}]},{"type":"codeBlock","content":[{"text":"message Capability {\n Version finp2pVersion = 1;\n (TBD)\n}","type":"text"}]},{"type":"paragraph"}],"version":1}