## Access Handshake + IPFS Content

Examples:

- ipfs.act/ - Example Page created by Nathan.Woodburn/
- ipfs.freeconcept/ - Example Multipage website created by Nathan.Woodburn/

## About Fire Portal

Fire Portal connects Handshake domains to IPFS content, enabling truly decentralized websites. It resolves Handshake domains, finds their IPFS content identifiers, and serves the content.

### How it works

1. A Handshake domain is resolved to get its DNS records
2. IPFS content identifiers are extracted from TXT records
3. Content is fetched from the IPFS network
4. The content is served to your browser

URL format: `https://ipfs.hnsproxy.au/[domain]/[path]`
Replace `[domain]` with any Handshake domain and `[path]` with an optional path.

## How to setup IPFS on your domain

To set up your Handshake domain to work with IPFS, follow these steps:

1. Get the IPFS hash of your content using any IPFS content hosting provider
2. Update your Handshake domain's DNS records with a TXT record
3. Use the format: `ipfs=Qm...your-ipfs-hash` or using IPNS `ipns=your-ipns-hash`
4. Add an A record to point your domain to this portal `192.9.167.104`
   Alternatively you can use this ALIAS `ipfs.hnshosting`
5. Wait a few minutes and you should be able to see your IPFS content on the domain

Watch a video tutorial

## API Reference

Fire Portal provides API endpoints to programmatically interact with the service:

- Force Refresh: `GET /api/refresh/{domain}` - Forces a refresh of IPFS content for a domain