aljaz/lsp
1
0
Fork 0
mirror of https://github.com/aljazceru/lsp.git synced 2025-12-17 06:04:20 +01:00
Code Issues Packages Projects Releases Wiki Activity

Removing liquidity marketplace spec

Browse Source
This commit is contained in:
Aljaz Ceru
2023-04-17 11:13:49 +02:00
parent 52daf49bfc
commit b71611f828
1 changed files with 0 additions and 122 deletions
Download Patch File Download Diff File Expand all files Collapse all files

122
liquidity-marketplace-spec.md
View File

@@ -1,122 +0,0 @@
# Liquidity marketplace spec
**This liquidity marketplace specification is OBSOLETE**. The quality of this specification is not sufficient and there is currently no interest to improve it. Therefore, we have made it obsolete. We discourage any usage.
## Version: 0.0.1
### Summary
Creating interoperable liquidty API we can make integrations between LSPs easier and enable consumers to utilize liquidity from wider selection of providers
### Order
| Field | Description | Unit | Required | Schema
|---|---|---|---|---|
| min_size | minimum chan size i'm willing to sell | sats |yes|integer|
| max_size | total available capacity | sats |yes| integer |
| base_fee | fixed fee charged for lease | sats | yes | integer
| rate_fee | example: size*0.002/duration | expressed as formula |yes|integer|
| min_duration | promise to keep open for minimum this amount of time / blocks | time |yes| integer |
| chan_base_fee | promise to not charge greater than this base fee | sats|yes| integer|
| chan_rate_fee | promise to not charge greater than this ppm | ppm |yes|integer|
| pub_key | who is selling the liquidity | N/A|yes| string
| policy | additional optional information |N/A|no| string
#### Order example (with policies)
```
{
"min_size": "100000",
"max_size": "999999",
"base_fee": "12000",
"rate_fee": "size*0.002/min_duration",
"min_duration": "1440",
"chan_base_fee": "0",
"chan_rate_fee": "1337",
"pub_key": "0288037d3f0bdcfb240402b43b80cdc32e41528b3e2ebe05884aff507d71fca71a",
"policy": [
{
"name": "duration_unit",
"value": "blocks",
"info": "unit for min_duration on our platform is blocks"
},
{
"name": "fee_policy",
"value": "",
"info": "we have different fee tiers based on chan sizes, more at https://lsp.com/rates.html"
},
{
"name": "push_support",
"value": "true",
"info": "we support pushing part of the balance on your side, up to 2btc in size"
}
]
}
```
### Policies
Policy field is an json object that can include various different policies that are **not mandatory** and serve as an additional information provided. Spec covers a list of predefined policies for common use-cases. Adding provider specific policies is supported and commonly used policies will be added to future versions of the spec.
##### Communitiy supported policies
1. **closing_policy** - under what conditions will you close the channels or leave it open
2. **fee_policy** - if you have tiered system for routing fees you're charging
3. **max_htlc_size** - what is the max htlc size you'll be allowing on the chan, useful for flow control
4. **min_htlc_size** - what is the min htlc size you'll be allowing on the chan, if you for example don't want to route 1sat payments over these chans
5. **reputation** - what reputation systems are you using and their links
6. **push_support** - if you support pushing part of the balance to buyers side
7. **duration_unit** - what units are you using for `min_duration`
8. **contact** - contact information where node operator/lsp can be reached (tg/twitter/web)
9. **location** - node location information
10. **tos** - where to find terms of use, legal, etc
##### Policy schema
| Field | Description | Required | Schema
|---|---|---|---|
| name | snake case policy name | yes|string|
| value | machine readable value | no|string/number|
| info | additional information | no|string|
##### Policy example
```
{
"policies": [
{
"name": "max_htlc_size",
"value": "123456",
"info": "i will enforce this policy for channels smaller than 50million"
},
{
"name": "closing_policy",
"value": "123456",
"info": "i will enforce this policy for channels smaller than 50million"
},
{
"name": "reputation",
"value": "https://fulmo.org/bos-score.csv",
"info": "https://fulmo.org/bos-score.html"
},
{
"name": "rate_fee_formula",
"value": "",
"info": "size*(100/size)"
},
{
"name": "fee_policy",
"value": "",
"info": "we have different fee tiers based on chan sizes, more at https://lsp.com/rates.html"
},
{
"name": "push_support",
"value": "true",
"info": "we support pushing part of the balance on your side, up to 2btc in size"
}
]
}
```