Skip to main content



pip install arseeding

Upload file

import arseeding, everpay

# ar account
#signer = everpay.ARSigner('your ar wallet file')

# eth account
signer = everpay.ETHSigner('your private key')

data = open('the name of file you want to upload', 'rb').read()

# send data to default arseeding service:
# you could set your own arseeding:
# order = arseeding.send_and_pay(signer, 'usdc', data, arseed_url="your arseeding service url")
# pay usdc in your everpay account
order = arseeding.send_and_pay(signer, 'usdc', data)

# order['itemId'] is your file item id.
# you could view your file in['itemId'] or['itemId']


create a file。

import arseeding, everpay
# ar account
# signer = everpay.ARSigner('ar_wallet.json')
# eth account
signer = everpay.ETHSigner(pk)
folder = 'build'
currency = 'USDC'
index_page ='index.html'
arseedUrl = ''
payUrl = ''
# upload folder public
maniId, fee1, fee2 = arseeding.upload_folder_and_pay(signer, currency, folder, index_page,arseedUrl,payUrl,slient=False)

Configuration Notes::

  • signer is the created signature instance, currently supports two types of signature instances.
    • Arweave compatible RSA encryption system compatible with Arweave.
    • ECC encryption system compatible with Ethereum。
  • folder : folder path need to upload。
  • payUrl is the URL of the everPay service that needs to be configured: default url if you ignore this parameter)
  • arseedUrl is the URL of the Arseeding backend service, here we use the public Arseeding service provided by permadao: default url if you ignore this parameter)
  • currency is the payment token you need to choose, if your MetaMask address in everPay holds usdc, please fill in usdc here, if it holds other tokens, please fill in the symbol of other tokens.
  • index_page is the default index file for manifest. Static websites are usually index.html ( default value ).

Execute the following command in the terminal for file upload:

$ python3


  • maniId is the id that contains the structure information of the folder,In this tutorial, we are uploading a docusaurus front-end project, and running yarn build under that project will generate a build folder, which is the one we uploaded. Now, we can access the site via arseedUrl/maniId!
  • fee1 total cost。
  • fee2 total cost(ignore decimals)。fee1 == fee2 * 10^decimals。