Astroport.ONE Developer Platform

To enable smart contract processing, you need to identify different event types in your application:

Event Kinds (NOSTR Standard)

• kind: 1 - Text notes (posts, comments)
• kind: 7 - Reactions (likes, emojis)
• kind: 21 - Short videos (NIP-71)
• kind: 22 - Long videos (NIP-71)
• kind: 1063 - File uploads (NIP-94)
• kind: 42 - Channel messages (NIP-28)
• kind: 1111 - Comments on URLs (NIP-22)

Custom Event Tags

Use tags to add context that smart contracts can use:

const event = {
  kind: 1,
  content: "My post",
  tags: [
    ['t', 'myapp'],           // Topic/category
    ['g', '48.86,2.35'],     // Geolocation
    ['r', 'https://...'],     // Reference URL
    ['p', 'pubkey'],          // Reference pubkey
    ['custom', 'value']       // Custom data
  ]
};

When you publish a video upload event (kind 21), a smart contract automatically:

// Your app publishes this event
const videoEvent = {
  kind: 21,
  content: "My video",
  tags: [
    ['url', '/ipfs/QmXXX'],
    ['title', 'My Video Title'],
    ['thumbnail', '/ipfs/QmYYY']
  ]
};

// Smart contract on Astroport station automatically:
// 1. Validates the event structure
// 2. Checks IPFS file exists
// 3. Generates additional thumbnails if needed
// 4. Updates video database
// 5. Notifies subscribers
// 6. Processes payment if required

Required Format: Netscape HTTP Cookie File format (exported from browser extensions)

Single-Domain Only

Each cookie file must contain cookies for one domain only (and its subdomains).

Example Cookie File:

# Netscape HTTP Cookie File
# https://curl.haxx.se/rfc/cookie_spec.html
# This is a generated file! Do not edit.

.youtube.com	TRUE	/	TRUE	1796910450	__Secure-Install	uuid-value
.youtube.com	TRUE	/	TRUE	1796910450	VISITOR_INFO1_LIVE	visitor-id
.youtube.com	TRUE	/	TRUE	1793886482	PREF	preference-value

Storage Location:

Cookies are stored in your MULTIPASS directory:

~/.zen/game/nostr/EMAIL/
├── .youtube.com.cookie      # YouTube cookies (single-domain)
├── .leboncoin.fr.cookie     # Leboncoin cookies (single-domain)
├── .DOMAIN.cookie           # Any domain cookie (single-domain)
└── APP/
    └── uDRIVE/              # Scraped content (videos, music, etc.)

• Cookie Manager Interface Upload and manage your cookies
• Full Documentation Complete cookie system documentation
• YouTube Interface See YouTube scraper in action
• Example Scrapers:
  • Astroport.ONE/IA/youtube.com.sh - YouTube video sync
  • Astroport.ONE/IA/leboncoin.fr.sh - Leboncoin ad scraper
  • Astroport.ONE/IA/scraper_leboncoin.py - Python backend example

// Include libraries
<script src="https://ipfs.copylaradio.com/ipns/copylaradio.com/nostr.bundle.js"></script>
<script src="https://ipfs.copylaradio.com/ipns/copylaradio.com/common.js"></script>

// Connect user
async function login() {
  try {
    const pubkey = await connectNostr(true); // true = force NIP-42 auth
    console.log('User connected:', pubkey);
    
    // Convert to npub for display
    const npub = hexToNpub(pubkey);
    console.log('User npub:', npub);
    
    return pubkey;
  } catch (error) {
    console.error('Login failed:', error);
  }
}

// Publish a simple text post
async function publishPost(content) {
  const result = await publishNote(content);
  if (result.success && result.eventId) {
    console.log('Post published:', result.eventId);
    return result.event;
  }
  throw new Error('Failed to publish: ' + result.errors.join(', '));
}

// Publish a post with tags (for smart contract processing)
async function publishPostWithTags(content, tags) {
  const result = await publishNote(content, tags);
  if (result.success && result.eventId) {
    console.log('Post with tags published:', result.eventId);
    return result.event;
  }
  throw new Error('Failed to publish: ' + result.errors.join(', '));
}

// Example: Post with geolocation and URL
await publishPostWithTags('Hello from Paris! ' + window.location.href, [
  ['g', '48.86,2.35'],  // Geolocation tag
  ['t', 'travel'],       // Topic tag
  ['r', window.location.href]  // Reference URL
]);

// Upload a file to IPFS
async function uploadFile(file) {
  // Upload to IPFS (automatically creates metadata)
  const result = await uploadPhotoToIPFS(file);
  
  console.log('File uploaded:', result.cid);
  console.log('IPFS URL:', result.ipfs_url);
  console.log('Metadata:', result.info);
  
  // The event is automatically published to NOSTR
  // Smart contracts will process it automatically
  
  return result;
}

// Handle file input
document.getElementById('fileInput').addEventListener('change', async (e) => {
  const file = e.target.files[0];
  if (file) {
    const result = await uploadFile(file);
    console.log('Upload complete:', result);
  }
});

// Subscribe to events from a specific user
async function subscribeToUser(pubkey) {
  // Connect to relay first
  await connectToRelay();
  
  // Subscribe to user's posts
  const sub = window.nostrRelay.sub([{
    kinds: [1],  // Text notes
    authors: [pubkey],
    limit: 10
  }]);
  
  sub.on('event', (event) => {
    console.log('New post:', event.content);
    // Process the event in your app
    displayPost(event);
  });
  
  return sub;
}

// Subscribe to events with specific tags (for smart contract results)
async function subscribeToTaggedEvents(tag) {
  await connectToRelay();
  
  const sub = window.nostrRelay.sub([{
    kinds: [1],
    '#t': [tag],  // Events with this tag
    limit: 50
  }]);
  
  sub.on('event', (event) => {
    // Smart contract may have added additional tags
    console.log('Event with tag:', event);
  });
  
  return sub;
}

Description: Connect to NOSTR wallet and optionally authenticate with NIP-42

Parameters:

• forceAuth (boolean, optional): If true, forces NIP-42 authentication

Returns: Promise resolving to user's hex pubkey

const pubkey = await connectNostr(true);

Description: Publish a NOSTR note event

Parameters:

• content (string): Note content
• additionalTags (array, optional): Additional tags for the event
• kind (number, optional): Event kind (default: 1)
• options (object, optional): Additional options

Returns: Promise resolving to result object with success, event, eventId, etc.

const result = await publishNote('Hello!', [['t', 'greeting']]);
if (result.success) {
  console.log('Event ID:', result.eventId);
}

Description: Upload a file to IPFS and publish metadata to NOSTR

Parameters:

• file (File): File object from input

Returns: Promise resolving to upload result with CID, IPFS URL, and metadata

const result = await uploadPhotoToIPFS(file);
console.log(result.cid, result.ipfs_url, result.info);

Description: Convert between hex and npub (bech32) formats

Parameters:

• hex (string): 64-character hex pubkey
• npub (string): bech32-encoded npub

Returns: Converted string or null if invalid

const npub = hexToNpub('60c1133d148ae0d2c4b42506fb4abacac903032680b178010c942bd538643f78');
const hex = npubToHex(npub);

Description: Send a reaction (like) to an event (NIP-25)

Parameters:

• eventId (string): ID of the event to react to
• authorPubkey (string): Author's pubkey
• content (string, optional): Reaction content (default: "+")

Returns: Promise resolving to published reaction event

await sendLike(eventId, authorPubkey, '❤️');