Skip to content

Commit

Permalink
SEP-1: Add contract field to CURRENCIES list (#1437)
Browse files Browse the repository at this point in the history
  • Loading branch information
JakeUrban authored Feb 15, 2024
1 parent 8571ed1 commit 471cad2
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions ecosystem/sep-0001.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ Title: Stellar Info File
Author: stellar.org
Status: Active
Created: 2017-10-30
Updated: 2022-05-27
Version: 2.5.0
Updated: 2024-02-01
Version: 2.6.0
```

## Simple Summary
Expand Down Expand Up @@ -114,11 +114,14 @@ The public key in the verification photo should be the issuing public key for th

These fields go in the `stellar.toml` `[[CURRENCIES]]` list, one set of fields for each currency supported. Complete all applicable fields, and exclude any that don't apply.

Currencies can be Stellar Assets that have been issued by a Stellar account and share the same common behaviors, or custom token contracts that satisfy the SEP-41 interface but implementation and behavior is customizable.

Field | Requirements | Description
------|--------------|------------
code | string (<= 12 char) | Token code
code | string (<= 12 char) | Token code. Required.
issuer | `G...` string | Stellar public key of the issuing account. Required for tokens that are Stellar Assets. Omitted if the token is not a Stellar asset.
contract | `C...` string | Contract ID of the token contract. The token must be compatible with the [SEP-41 Token Interface](sep-0041.md) to be defined here. Required for tokens that are not Stellar Assets. Omitted if the token is a Stellar Asset.
code_template | string (<= 12 char) | A pattern with `?` as a single character wildcard. Allows a `[[CURRENCIES]]` entry to apply to multiple assets that share the same info. An example is futures, where the only difference between issues is the date of the contract. E.g. `CORN????????` to match codes such as `CORN20180604`.
issuer | `G...` string | Token issuer Stellar public key
status | string | Status of token. One of `live`, `dead`, `test`, or `private`. Allows issuer to mark whether token is dead/for testing/for private use or is live and should be listed in live exchanges.
display_decimals | int (0 to 7) | Preference for number of decimals to show when a client displays currency balance
name | string (<= 20 char) | A short name for the token
Expand Down

0 comments on commit 471cad2

Please sign in to comment.