Use Python SDK
Getting Started with Lighthouse Python SDK - Store Files Permanently
Welcome to the beginner's tutorial on using the Lighthouse Python SDK for perpetual and decentralized file storage. Lighthouse is a cutting-edge file storage protocol that revolutionizes the traditional rent-based cost model of cloud storage by enabling users to pay once for their files and store them forever. With the integration of IPFS, Filecoin, and smart contracts on various blockchain networks, Lighthouse ensures data permanence, enhanced security, and cost-efficiency. This tutorial will guide you through the essential steps of leveraging the Lighthouse Python SDK to manage files perpetually on the decentralized network.
Traditional file storage models require users to periodically renew their storage subscription, leading to recurring costs and management efforts. Lighthouse Python SDK eliminates these hassles by offering a perpetual storage model, where users pay once and store files indefinitely. This innovative approach utilizes the robustness of IPFS and the storage capacity of Filecoin's miner network, guaranteeing file permanence and redundancy. Let's dive into the Lighthouse Python SDK to harness the power of perpetual decentralized file storage.
Before starting with the Lighthouse Python SDK, ensure you have the following:
- 1.Basic knowledge of Python programming.
- 2.Python installed on your computer.
- 3.A Lighthouse API token. If you haven't obtained one yet, sign up on the Lighthouse website to get your API token.
- 2.Select any of the login method and perform verification steps
- 3.Click on API Key on the left side panel on the dashboard.
- 4.Insert name for your API
- 5.Copy the API Key
Begin by installing the Lighthouse Python SDK via pip, allowing you to interact with the Lighthouse protocol seamlessly:
pip install lighthouseweb3
After installing the SDK, import the required libraries and initialize the Lighthouse client with your API token:
from lighthouseweb3 import Lighthouse
# Replace "YOUR_API_TOKEN" with your actual Lighthouse API token
lh = Lighthouse(token="YOUR_API_TOKEN")
Next, let's upload a file to Lighthouse. We can use the
uploadfunction for this purpose. We'll demonstrate both regular file upload and file upload with tags:
# Regular file upload
source_file_path = "./path/to/your/file/or/directory"
upload = lh.upload(source=source_file_path)
print("Regular File Upload Successful!")
# File upload with tags
tagged_source_file_path = "./path/to/your/file/or/directory"
tag = "your_tag_name"
upload_with_tag = lh.upload(source=tagged_source_file_path, tag=tag)
print("File Upload with Tag Successful!")
After uploading a file, you might want to retrieve its information, such as the Content Identifier (CID). We can use the
getUploadsfunction for this purpose:
# Replace "YOUR_CID_TO_CHECK" with the actual CID you want to check
file_cid_to_check = "YOUR_CID_TO_CHECK"
list_uploads = lh.getUploads(file_cid_to_check)
Now, let's download a file from Lighthouse using its CID. We'll use the
downloadfunction to achieve this:
# Replace "YOUR_CID_TO_DOWNLOAD" with the actual CID of the file you want to download
file_cid = "YOUR_CID_TO_DOWNLOAD"
destination_path = "./downloaded_file.txt"
file_info = lh.download(file_cid) # The file_info is a tuple containing the file content and its metadata
file_content = file_info # Save the downloaded file to the destination path
with open(destination_path, 'wb') as destination_file:
# The file has been successfully downloaded and saved to the destination_path
Lighthouse allows you to check the status of a file's deal on the network. This can be useful to ensure that the file is accessible and replicated. Use the
getDealStatusfunction to check the deal status:
# Replace "YOUR_CID_TO_CHECK_STATUS" with the actual CID whose deal status you want to check
file_cid_to_check_status = "YOUR_CID_TO_CHECK_STATUS"
deal_status = lh.getDealStatus(file_cid_to_check_status)
If you've tagged your files during the upload, you can easily retrieve them by tag using the
# Replace "YOUR_TAG_TO_DOWNLOAD" with the actual tag name you want to download files for
tag_to_download = "YOUR_TAG_TO_DOWNLOAD"
downloaded_files_with_tag = lh.getTagged(tag_to_download)
print("Files Downloaded with Tag:")
Congratulations! You have successfully learned how to interact with the Lighthouse API for file upload, download, tagging, and checking deal status. You can now integrate Lighthouse into your own applications to manage files securely and efficiently. Keep exploring the Lighthouse documentation to discover more features and functionalities offered by the platform.
Remember to handle exceptions appropriately in your applications, and make sure to secure your API token to protect your data on the Lighthouse platform. Happy coding!