Developer Quickstart
Last updated
Was this helpful?
Last updated
Was this helpful?
Swan IPFS Storage is a suite of Ethereum scaling solutions that enables high-throughput, low cost smart contracts while remaining trustworthy secure.
The following documentation describes how to use Swan IPFS Storage, which is currently live on Swan Mainnet. Whether you're a developer that just wants to start building or you're curious into digging deeper into the internals of Swan IPFS Storage and how it works, this site is the right place for you.
Token Swap: Token Swap module is in charge of swap the user's token to wrapped token, it can be USDC or other tokens.
Users pay USDC or other tokens, which are called user tokens, when uploading a file.
Swan IPFS Storage uses FIL, which is called wrapped token, to pay when store data to Filecoin network.
User tokens should be changed to wrapped token by this module and this step is called token exchange(swap).
Token exchange(swap) is done through Sushi Swap which is a DEX.
After a file is uploaded, the money to be paid is estimated based on the
the average price of all the swan miners;
file size;
duration;
In refund step, the overpayment part that is locked will be returned to user wallet
DAO Signature: If DAO detects that the file uploaded has been chained, it will trigger a signature operation
OS: Ubuntu 20.04 LTS
Mysql5.5+
Lotus node is used for making car files and sending offline deals.
Install lotus node or louts lite node in the same machine as Swan IPFS Storage.
Lotus full node is too heavy compared with lotus lite node, so lotus lite node is preferred.
Lotus lite node depends on a lotus node, so ensure that a lotus node exists somewhere when using lotus lite node.
🔔go 1.16+ is required
Before executing, you should check your configuration in ~/.swan/mcp/config.toml to ensure it is right.
Before executing, you should check your enviornment variable in ~/.swan/mcp/.env to ensure it is right.
After set your config and env variable in the related files, you can run multi-chain-payment in ./build directory.
Logs are in directory ./logs
You can add nohup before ./multi-chain-payment to ignore the HUP (hangup) signal and therefore avoid stop when you log out.
You can add >> mcp.log in the command to let all the logs output to mcp.log.
You can add & at the end of the command to let the program run in background.
Such as:
You need to modify the config file and input your config params, the configuration items will be introduced below:
port: Web api port.
release: When work in release mode: set this to true, otherwise to false and environment. variable GIN_MODE not to release.
swan_platform_fil_wallet: The wallet address used to pay on the Filecoin network.
filink_url: Deals data can be searched from here.
[lotus]
[ipfs_server]
download_url_prefix: IPFS server url prefix, such as: http://[ip]:[port]. Store car files for downloading by storage provider. Car file url will be [download_url_prefix]/ipfs/[file_hash]
upload_url_prefix: IPFS server url for uploading files, such as http://[ip]:[port]
[swan_task]
dir_deal: Output directory for saving generated Car files and CSVs.
verified_deal: [true/false] Whether deals in this task are going to be sent as verified.
fast_retrieval: [true/false] Indicates that data should be available for fast retrieval.
start_epoch_hours: start_epoch for deals in hours from current time.
expired_days: expected completion days for storage provider sealing data.
max_price: Max price willing to pay per GiB/epoch for offline deal.
generate_md5: [true/false] Whether to generate MD5 for each car file, note: this is a resource consuming action.
[polygon]
rpc_url: your polygon network RPC URL.
payment_contract_address: swan payment gateway address on polygon to lock money.
sushi_dex_address: sushi address on polygon.
usdc_wFil_pool_contract: address to get exchange rate between USDC and wFil from sushi on polygon.
dao_contract_address: swan DAO address on polygon, to receive DAO signatures.
mcp_payment_receiver_address: Swan IPFS Storage wallet address to receive money from unlock operation.
gas_limit: gas limit for transaction.
unlock_interval_minute: unlock interval in minutes between 2 unlock operations, in cannot be less than 1.
privateKeyOnPolygon: private key of the wallet used to execute contract methods on the polygon network and pay for gas.
If you're looking to discover how Swan IPFS Storage works, the best place to begin is by the section, which gives a high level overview of Swan IPFS Storage's internals. From there, you can jump into more detailed explainers on various components of the system.
Then the estimated amount of money will be locked to the payment contract address, see .
In unlock step, the amount pay to Filecoin network by swan platform FIL wallet, will be transferred to Swan IPFS Storage payment receiver address, see .
Swan Client API: More information can be found .
Data DAO: More information can be found at .
IPFS: More information can be found .
Filecoin Storage: More information can be found .
Option1️⃣
Option2️⃣
client_api_url: URL of lotus client web api, such as: http://[ip]:[port]/rpc/v0, generally the [port] is 1234. See
client_access_token: Access token of lotus client web api. It should have admin access right. You can get it from your lotus node machine using command lotus auth create-token --perm admin. See
Want to learn more? Check out the and . Join the team on .
