Getting Started with Lighthouse Python SDK
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:
Go on https://files.lighthouse.storage/ and Click on Login
Select any of the login method and perform verification steps
Click on API Key on the left side panel on the dashboard.
Insert name for your API
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 upload function 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 getUploads function 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 download function 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 getDealStatus function 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 getTagged function:
# 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!
Read our latest blog
Encryption and Access Control for Web3 using Lighthouse
How To Migrate Your Files To Lighthouse
Decentralized storage for the Ocean Protocol
Creating a Pay-to-View Model Using Lighthouse Storage
Getting Started with Lighthouse Python SDK
A Comprehensive Guide to Publishing and Updating Content with Lighthouse IPNS
Aryaman Raj, Nandit Mehra
Time Lock Encryption using Lighthouse Access Control
Secure File Sharing using Lighthouse SDK: A Step-by-Step Guide
Passkey Demo App with WebAuthn and Ethereum
Web3 Storage: IPFS and Filecoin Guide
Understanding How web3 storage Operates
Lighthouse: Secure Web3 Storage for Your AI Data
Decentralized Storage: A Smarter, Safer, and Cheaper Way to Manage Your Data
Unveiling the Mechanics of Perpetual Storage
Navigating Permanent Storage: Harnessing the Power of Filecoin and IPFS
Decentralized Excellence: Elevating Data Storage with Lighthouse
Revolutionizing Permanence in Data Storage
Eternalizing Data: A Permanent storage
Exploring Web3 Advancements in Storage Solutions
NFT Storage Strategies
On-Chain Encryption: Security Unveiled