BSI PAS 19668:2020 Tool

PAS 19668:2020 is a specification for the publication requirements for security tokens. The tools on this page allow you to create PAS 19668:2020 compliant JSON data and check the validity of any manually edited data.

“Security tokens allow securities to be digitized in a manner that’s expected to increase openness and the inter-operability of the financial system. Until now there’s been no cross-blockchain industry-wide standard on how information and properties relating to security tokens should be structured and presented. PAS 19668:2020 introduces a cross-chain standard that harmonizes the publication and access of security token attributes as disclosed by the asset issuer. It provides requirements for the consistent publication of relevant information and the technical attributes of security tokens.”

—BSI Group.

“[PAS 19668:2020] provides requirements for the publication of relevant information and the technical attributes of security tokens. It covers security tokens issued on any distributed ledger system. It does not cover utility tokens or unregulated tokens. This PAS is for use by UK and international security token issuers. The PAS is also of interest to security token holders, investors in security tokens, security token exchanges and custodians and any other third parties that provides services to the issuers of security tokens, investors in security token and auditors who might be checking conformity.”

—PAS 19668:2020 definition of scope.

Many of the fields required for PAS 19688:2020 compliance are hidden and defaulted to values that are correct for assets issued as security tokens using Blockstream AMP. There is also a tool that pulls asset issuance data from the Liquid network’s blockchain, which can optionally be added as custom data to the end of the JSON.

Liquid Asset Issuance Data

Before generating the JSON data, you can check the details of any publically issued asset, whether it was issued using a Liquid node directly, or via the Blockstream AMP API. You can manually add these details to the CustomElements section at the end of the JSON data if you want to.

Liquid Asset ID (an example value is provided below for demonstration purposes).

Generating BSI PAS 19668:2020 Formatted JSON Data

Fill in the fields below to generate PAS 19668:2020 compliant JSON data.

The sections below are laid out in line with the format defined in PAS 19668:2020. You can hover over field names to view tooltip information of the field definitions. Please refer to the PAS document for more details on field definitions.

Note

Some of the required PAS fields will be added using the default values for Blockstream AMP issued assets. If you need to amend these, you can manually edit the JSON after you generate it. Example field values have been included in some of the fields below to demonstrate the tool's output. Please be sure to amend these before generating and publishing your own data.

VersionControl

PAS Standard Version Number Version of the PAS

Security Token File Version Number This is the version of the file in the SecurityTokenDataStore for the specific asset described in the file. The version is specified as major.minor.revision, e.g. 1.17.57.

Security Token Data Store

Security Token Data Store Web-link or InterPlanetary File System (IPFS) link to the location where the security token's data (the JSON data generated by this tool) is currently stored, for example on your website.

Security Token Location

STBlockchain

Security Token Blockchain Name Name of the blockchain network where the security token is hosted.

Security Token Blockchain Information Link to additional information on the blockchain network where the security token is hosted.

ST Tokenization Solution Link to additional information on the tokenization solution used to create the token on the blockchain network. For example, Blockstream AMP
Please select... Liquid Blockstream AMP

Security Token Blockchain Unique Asset Identifier The Liquid Asset ID that represents the token.

Programmation Of Security Token Set to ProgramSmartContract if the Blockchain allows for programming of Security Token via smart contract or application. Set to ProgramCryptoConditions if the Blockchain allows for Security Token programming via crypto conditions. Set to ProgramNone if the Blockchain does not support smart contracts applications or crypto conditions.
Please select... Program Smart Contract Program Crypto Conditions Program None
Security Token Transfer Verification Logic Set to VerificationPostTransfer if the Sender is able to send the Security Token to a recipient without the recipient being the registered owner of the Security Token. The Recipient is then able to register with the Issuer of the Security Token to be added to the register of ownership. Set to VerificationPreTransfer if the Sender is only able to transfer to a Recipient if the Recipient is already registered with the Issuer of the Security Token. Set to VerificationByEscrow if the transfers require a third-party consent to proceed. Set to VerificationPreTransferWithApproval if the Sender is only able to transfer to a Recipient if the Recipient is already registered with the Issuer of the Security Token and the Recipient has approved the transfer.
Please select... Verification Post Transfer Verification Pre Transfer Verification By Escrow Verification Pre Transfer With Approval
SecurityProcedures See tool tips for each item below for details.

Capable Freeze Account Include CapableFreezeAccount if the smart contract, application or crypto conditions provide a function to disable transfers of a particular account holding security tokens.
Capable Freeze ST Include CapableFreezeST if the smart contract, application or crypto conditions provide a function to disable transfers of tokens across all accounts.
Capable Upgrade Include CapableUpgrade if the smart contract, application or crypto conditions provide a function to be able to upgrade the token.
Capable Delegation Include CapableDelegation if the smart contract, application or crypto conditions provide a function to allow third parties to the Issuer to have administrative rights over the token.
Capable Reverse Transaction Include CapableReverseTransaction if the smart contract, application or crypto conditions provide a function to reverse a transaction.
Capable Force Transfer Include CapableForceTransfer if the smart contract, application or crypto conditions provide a function in a smart contract to force the transfer of a token.

Security Token Identification Number

Security Token Identification Number Asset identification according to BS EN ISO 6166.

Security Token Classification

CFI Code Version Classification information for the security token described herein. CFI Code version.

CFI Code Value Classification information for the security token described herein. CFI Code based on the CFI Code version.

Information Disclosures

Issuer Disclosures

Issuer Name Legal name of the issuer of the security token as found on the certificate of incorporation or official name.

Issuer Industry Classification Refer to North American Industry Classification System (NAICS) [N1].

Issuer Jurisdiction BS ISO 3166-1 country code of the issuers’ country of incorporation. Application of classification code conforming to BS ISO 3166-1.

Issuer Contact Details Full, up-to-date contact details of the issuer of the security token.

Issuer News Feed Official news source of the issuer. A link to the blog or webpage of the issuer or an XML file representing a newsfeed.

Issuer Incorporation Documents Web or IPFS link to the relevant documents of incorporation of the issuer of the security token.

Issuer Offering Documents Web or IPFS link to the relevant offering documents from the issuer of the security token.

Issuer Account Information Web or IPFS link to the latest account document from the issuer of the security token.

Issuer Asset Disclosures

Security Token Total Supply Total number of security tokens in circulation across all blockchain instances of the virtual asset.

Security Token Fractionalization Set to true if an investor can hold a fraction of a security token.
Please select... True False
Asset Investment Profile Asset investment profile might contain information such as Price Per Earnings ratio, Price to Sales Ratio, Insider Trades, Gross Margin, Operating Margin.

Markets Links to markets where the security token might be traded.

Price Determination Attribute that affects the pricing of the security token. Set to STMarketPrice if the asset price is set by the market. Security token price is determined by the market, i.e. the token is freely traded. Set to STFixedPrice if security token price is fixed, i.e. the issuer only allows the sale of the security token at its own valuation.
Please select... Market Price Fixed Price
Asset Backing Indicated whether the security token is backed by a real-world asset and whether a custodian has custody of the asset. Set to AssetBacked if the security token is backed by a real-world asset (e.g. security token issued by tokenizing securities certificates and making an entry into a blockchain register). Set to NotAssetBacked if the security token is not backed by a real-world asset (e.g. security token issued by making an entry into a blockchain register instead of issuing a securities certificate).
Please select... Asset Backed Not Asset Backed
Asset Custodianship Indicate whether the security token underlying asset is held by a custodian or not. Set to AssetCustodied if the underlying asset is held by a custodian. Set to AssetNotCustodied if the underlying asset is not held by a custodian.
Please select... Asset Custodied Asset Not Custodied
Asset Custodian Name of the custodian or custodians that custody the real-world asset that was tokenized.

Eligible Investor Classification

Eligible Investor Countries

Eligible Investor Country BS ISO 3166-1 country code of the location of the investors. For example: GB.

Eligible Investor Classification Definition of the acceptable investor type as defined by local laws together with a link to official reference data about that investor type. For example: Retail or Professional

Eligible Investor Classification Definition Link to official reference data about that investor type. For example: if EligibleInvestorCountry is set to GB and EligibleInvestorClassification set to Retail, this field would contain a link to the FCA website.

Add Country

Restricted Countries

Restricted Country BS ISO 3166-1 country codes of any jurisdictions that the issuer wants to restrict.

Add Country

Security Token Technical Properties

Income Properties Set to IncomeSameAddress for a token that automatically pays out dividends or other income to the same crypto-address as where the token is held. Set to IncomeDifferentAddress for a token that automatically pays out dividends or other income to an address that is different from the crypto-address where the token is held. Set to IncomeUponRequest for a token that pays out dividends or other income upon request of the holder to the same crypto-address as where the token is held. Set to NoIncomeToken for a token that has no rights to any income.
Please select... Income Same Addres Income Different Address Income Upon Request No Income Token
Voting Properties Set to VotingRequired for tokens requiring holders to vote on proposals through the token smart contract or application. Set to NoVoting for tokens that have no voting rights.
Please select... Voting Required No Voting
Delegated Register Set to DelegateTA if the smart contract, application or crypto conditions provide a function to allow for a Transfer Agent apart from the Issuer to administer the register of owners. Set to DelegateCSD if the smart contract, application or crypto conditions provide a function to allow for a CSD apart from the Issuer to administer the register of owners. Set to DelegateOther if the smart contract, application or crypto conditions provide a function to allow for others apart from the Issuer to administer the register of owners.
Please select... Delegate TA Delegate CSD Delegate Other

KYC & AML Requirements

Identity

Identity Document Free text field. List the identification requirements for registration or transfer of the security token e.g "Passport or driving license".

Add identity document to list

Compliance

Compliance Requirement Free text field. List any additional compliance requirements beyond Eligible Investor Classification that will affect the onboarding of investors e.g. "KYC, AML accreditation".

Add compliance requirement to list

Generate BSI formatted JSON data

Generates PAS 19668:2020 compliant JSON data from the above.

Generate PAS 19668:2020 JSON Data

Your PAS 19668:2020 formatted data will be displayed here

Custom Elements

You can manually add your own custom elements to the JSON after it has been output above.

The CustomElements section within the JSON allows users of the PAS to add their own custom message items that are not yet included in the PAS. The custom elements item can be used while the PAS is in the process of being updated or an Issuer can enter their own key value pairs to further describe the asset.

If you want to include Liquid/Blockstream AMP Asset Issuance data as the custom elements data, use the "Display Asset Issuance Details" option at the top of the page and paste the results into the CustomElements section as below.

"CustomElements": {
    "asset_id": "a28d04f3e243a9a187f4a8b797be2f19a9c01b6ef4e1d65bfb6abbd6a2042097",
    "issuance_txin": {
        "txid": "0c3ec80b0912b1c6d276e92c28161b684afcbd49a276ca079f3cca245a458d48",
        "vin": 0
    },
    ...etc
 }
}

Validate JSON data

Paste any manually created JSON into the box below to test if it is valid JSON or not. You may wish to do this if you have added your own CustomElements section at the end of the data.

The text box accepts JSON, not strings with JSON in. {"key": value} is ok '{"key": value}' is not. Please note that the validation does not check against the PAS 19668:2020 standard, it checks for JSON validity only.

JSON to be validated


Validate

The result of validating the JSON will be shown here.