n8n-nodes-photocertif

⚠️ Beta Status: This node is in active development. Features are functional but we're continuously improving based on user feedback. Join our Discord channel for support and updates.

Custom n8n node for PhotoCertif - Image/Photo and Art certification on Solana blockchain with fully automated B2B workflows.

🎯 Features

Core Operations

• 📤 Upload Documents & Images - Upload content for secure storage
  • ⭐ NEW: URL Support - Upload from Google Drive, Dropbox, or any public URL
  • Base64 encoding - Traditional method with base64 strings
• 💰 Get Pricing - Retrieve current CHECKHC pricing in real-time
• 📝 Submit Certification - Prepare certification with all metadata
  • ✅ All optional fields supported (social links, collection, etc.)
  • 🚧 C2PA Support - Content authenticity certification (In Development)
• 🔍 Get Status - Monitor certification progress
• ⏳ Wait for Certification - Poll status until completion (with timeout)
• 📥 Download Content - Retrieve certified files
• 🎨 AI Analysis - Automatic AI detection for art certification (media/image2)

🚀 NEW: Automated B2B Workflows (v2.0)

• 💳 Automated CHECKHC Payment - Pay from n8n using Solana Wallet credential
• 🤖 Server-Side NFT Minting - NFT created and transferred automatically
• ⚡ Zero Human Intervention - Complete end-to-end automation
• 🔐 Secure Credential Storage - API Keys + Solana Wallet encrypted in n8n

🚀 Fully Automated B2B Workflows

Complete end-to-end automation with zero human intervention:

• ✅ Upload - n8n uploads documents/images to PhotoCertif
• ✅ Get Pricing - Retrieves current CHECKHC pricing in real-time
• ✅ Pay Automatically - n8n pays with CHECKHC from Solana Wallet credential
• ✅ Mint NFT - PhotoCertif mints NFT server-side automatically
• ✅ Transfer - NFT transferred to payer wallet
• ✅ Monitor - Check status and completion

Use Cases:

• 📄 High-volume document certification (100s-1000s)
• 🎨 Art collection certification and authentication
• 🏢 B2B integrations and partnerships
• 🔄 Automated certification pipelines
• ✅ Enterprise compliance workflows
• 📊 Batch processing with monitoring

📦 Installation

Via n8n Community Nodes (Recommended)

1. Go to Settings → Community Nodes
2. Click Install
3. Enter: n8n-nodes-photocertif
4. Click Install

Manual Installation (Development)

cd ~/.n8n/nodes
npm install /path/to/n8n-nodes-photocertif

Restart n8n after installation.

🔑 Configuration

Credential 1: PhotoCertif API (Required)

1. Open n8n → Credentials → New Credential
2. Search for "PhotoCertif API"
3. Fill in:
   • PhotoCertif URL: https://app2.photocertif.com
   • API Key: pk_live_xxxxxxxxxxxxx

Generate API Key:

1. Go to https://app2.photocertif.com
2. Login → My Account → API Keys → Create API Key
3. Select scopes: docs:read, docs:upload, docs:write
4. Copy the API key (starts with pk_live_ or pk_test_)

Credential 2: Solana API ⭐ (Required for Automated Payments)

Included in: This package includes the Solana API credential

Required for: Automated CHECKHC token transfers and blockchain operations

1. Open n8n → Credentials → New Credential
2. Search for "Solana API"
3. Fill in:
   • Network: Mainnet Beta (or Devnet for testing)
   • RPC Endpoint Type: Public RPC or Custom RPC (Helius/QuickNode for better performance)
   • Private Key: Your Solana wallet private key (base58 format)
   • Public Key: Your Solana wallet address

✅ Benefits:

• Reusable across multiple n8n nodes (PhotoCertif, SolanaSwap, etc.)
• Flexible RPC configuration (public or private endpoints)
• Complete Solana API access for advanced workflows

⚠️ Security Recommendations:

• Use a dedicated wallet for n8n (not your main wallet)
• Store only the necessary CHECKHC tokens (~1000-10000 for testing)
• The private key is encrypted in n8n credentials
• Never share your private key

Get a Private Key:

Option A - Export from Phantom:

1. Open Phantom → Settings → Security & Privacy
2. Export Private Key → Copy (base58 format)

Option B - Create new wallet:

node -e "
const {Keypair} = require('@solana/web3.js');
const bs58 = require('bs58');
const k = Keypair.generate();
console.log('Address:', k.publicKey.toString());
console.log('Private Key:', bs58.encode(k.secretKey));
"

Fund the Wallet:

• Buy CHECKHC tokens: https://jup.ag/swap/SOL-CHECKHC
• Send to your n8n wallet address
• Recommended: 500-10000 CHECKHC (~$3-50)

📚 Operations

1. Get Pricing ⭐ NEW

Get current CHECKHC pricing for certification services.

Parameters:

• Resource Type: docs or image2

Returns:

{
  "success": true,
  "type": "docs",
  "price_checkhc": 175.48,
  "price_usd": 1.0,
  "checkhc_mint": "5tpkr...49uau",
  "payment_wallet": "C6bK...hESFg",
  "network": "mainnet-beta"
}

2. Upload ⭐ Enhanced with URL Support

Upload a document or image to PhotoCertif.

Parameters:

• Resource Type: docs (documents) or image2 (art)
• Input Type ⭐ NEW:
  • Base64 String - Traditional base64 encoded content
  • URL - Download from Google Drive, Dropbox, or any public URL
• File (Base64): Base64 encoded content (if Input Type = Base64)
• File URL: Public URL to download file from (if Input Type = URL)
• Title: Content title (required)
• Description: Optional description

URL Examples:

// Google Drive
"https://drive.google.com/uc?id=FILE_ID&export=download"

// Dropbox
"https://www.dropbox.com/s/abc123/photo.jpg?dl=1"

// Direct URL
"https://cdn.example.com/images/photo.jpg"

Returns:

{
  "success": true,
  "storage_id": "iv_1234567890_abc123",
  "message": "Upload successful"
}

3. Submit Certification

Submit certification form with all metadata. Note: User must complete payment and minting in PhotoCertif interface.

Parameters (4 Required + 11 Optional):

Required:

• Storage ID: iv_xxxxx from upload
• Certification Name: Name for the NFT
• Symbol: 4 uppercase letters (e.g., CNTR)
• Description: Detailed description
• Owner: Owner name

Optional:

• Collection Mint Address: NFT collection to join
• Website URL: Project website
• Twitter URL: Twitter/X profile
• Discord URL: Discord server
• Instagram URL: Instagram profile
• Telegram URL: Telegram channel
• Medium URL: Medium blog
• Wiki URL: Documentation wiki
• YouTube URL: YouTube channel

Returns:

{
  "success": true,
  "storage_id": "iv_xxxxx",
  "notice": "Certification form submitted. User must complete payment...",
  "certification_url": "https://app2.photocertif.com/media/docs/certification?iv_storageid=iv_xxxxx"
}

3. Get Status

Check certification status.

Parameters:

• Storage ID: iv_xxxxx

Returns (docs):

{
  "id": "iv_xxxxx",
  "title": "Contract 2025",
  "status": "uploaded" | "certified",
  "created_at": "2025-01-06T20:00:00Z",
  "nft_address": "ABC123..." // if certified
}

Returns (image2 - with AI fields):

{
  "id": "iv_xxxxx",
  "title": "Artwork",
  "status": "certified",
  "nft_address": "ABC123...",
  "ai_generated": false,
  "ai_generated_score": 0.12,
  "ai_source": "HUMAN_CREATED",
  "Human_score": 0.88,
  "ai_prediction_id": "pred_xyz"
}

4. Wait for Certification ⭐

Poll status until certified or timeout. This is the key to automation!

Parameters:

• Storage ID: iv_xxxxx
• Polling Interval: Seconds between checks (default: 300 = 5 minutes)
• Max Wait Time: Maximum seconds to wait (default: 86400 = 24 hours)

How it works:

1. Checks status every X seconds
2. Returns immediately when status === "certified"
3. Times out if max wait time exceeded
4. Useful after user is notified to complete payment

Returns:

{
  "success": true,
  "status": "certified",
  "storage_id": "iv_xxxxx",
  "nft_address": "ABC123...",
  "wait_time_seconds": 1800,
  "attempts": 6,
  "message": "Certification completed after 1800 seconds (6 checks)"
}

5. Download

Download certified content.

Parameters:

• Storage ID: iv_xxxxx

Returns:

{
  "download_url": "https://...",
  "expires_at": "2025-01-07T20:00:00Z"
}

📂 Available Workflows

Docs Certification v2.2.0 (Recommended)

File: workflow-docs-certification-v2.2.0.json
Status: ✅ Tested & Production-Ready

Features:

• ✅ Automatic upload from URL or base64
• ✅ Real-time pricing with affiliate split calculation
• ✅ Auto SOL→CHECKHC swap if balance insufficient
• ✅ Automatic CHECKHC transfers to payment + affiliate wallets
• ✅ Server-side NFT minting and transfer
• ✅ Complete B2B automation - zero human intervention

Fixed in v2.2.0:

• 🐛 Fixed storageId path in certify operation (was causing HTTP 500)
• ✅ All nodes tested and validated end-to-end

Changelog: See WORKFLOW_V2.2.0_CHANGELOG.md

Previous Versions

• workflow-docs-certification-v2.1.0.json - ⚠️ Deprecated (storageId bug)
• workflow-docs-certification-v2.0.0.json - ⚠️ Deprecated
• workflow-image2-certification-v1.1.0.json - For art/image certification

🔄 Example Workflows

Workflow 1: Semi-Automated Certification

Manual Trigger
  ↓
PhotoCertif - Upload
  - Resource: docs
  - File: {{$json.base64_content}}
  - Title: "Contract 2025"
  ↓
PhotoCertif - Submit Certification
  - Storage ID: {{$json.storage_id}}
  - Name: "Contract2025"
  - Symbol: "CNTR"
  - Description: "Legal contract"
  - Owner: "Company ABC"
  ↓
Send Email - Notification
  - To: user@example.com
  - Subject: "⏳ Complete Certification Payment"
  - Body: "Click: {{$json.certification_url}}"
  ↓
PhotoCertif - Wait for Certification
  - Storage ID: {{$json.storage_id}}
  - Polling Interval: 300 (5 minutes)
  - Max Wait Time: 86400 (24 hours)
  ↓
Send Email - Success
  - Subject: "✅ NFT Minted!"
  - Body: "NFT: {{$json.nft_address}}"

Workflow 2: Bulk Upload with Monitoring

Schedule Trigger (Daily)
  ↓
Read Files from Folder
  ↓
Loop: For each file
  ↓
  PhotoCertif - Upload
    - File: {{$binary.data}}
    - Title: {{$json.filename}}
  ↓
  Store in Database
    - storage_id
    - status: "pending"
  ↓
Send Report
  - "Uploaded X documents, awaiting certification"

Workflow 3: Status Monitor

Schedule Trigger (Every hour)
  ↓
Database - Get Pending Certifications
  ↓
Loop: For each pending
  ↓
  PhotoCertif - Get Status
    - Storage ID: {{$json.storage_id}}
  ↓
  IF: status === "certified"
    ↓
    Database - Update Status
    ↓
    Send Notification
    ↓
    Generate Certificate PDF
    ↓
    Upload to Cloud Storage

💰 Pricing Information

PhotoCertif Pricing (Approximate)

Services:

• Documents (media/docs): ~1 USD per certification
• Art (media/image2): ~1 USD per certification

Blockchain Fees (paid in SOL from user wallet):

• Secure Storage: ~0.02-0.05 SOL
• NFT Minting: ~0.005 SOL
• Total: ~0.025-0.055 SOL per certification

Payment Process:

1. Prices are shown in USD in config
2. Converted to CHECKHC tokens dynamically
3. User pays with CHECKHC from their balance
4. Exchange rate: fetched from /api/pricing/current

🎨 Differences: docs vs image2

AI Fields (image2 only):

• ai_generated: Is it AI-generated?
• ai_generated_score: AI probability (0-1)
• ai_source: Certification level
• Human_score: Human probability
• ai_prediction_id: Prediction ID

🚧 Known Issues & Roadmap (Beta)

✅ Working & Tested:

• Upload (Base64 & URL)
• Get Pricing
• Automated CHECKHC payments
• Server-side NFT minting
• Batch certification workflows
• Google Drive/Dropbox integration

🐛 Known Issues:

• C2PA integration is in development (not yet production-ready)
• Some edge cases in large file uploads (>50MB) may need optimization
• Rate limiting on public RPC endpoints may affect high-volume batches

🛣️ Roadmap:

• C2PA content authenticity (Q1 2025)
• Enhanced metadata validation
• Improved error messages
• More file format support

Report issues: Join our Discord or GitHub Issues

🐛 Troubleshooting

"API Key invalid"

• Verify API key is correct
• Check scopes: docs:read, docs:upload, docs:write
• Regenerate if needed

"Certification timeout"

• User may not have completed payment yet
• Increase Max Wait Time parameter
• Send reminder notification

"Cannot connect to PhotoCertif"

• Verify PhotoCertif URL in credentials: https://app2.photocertif.com
• Verify n8n can reach external networks
• Check firewall rules

"Status stays 'uploaded'"

• Certification form submitted successfully
• User must pay and mint NFT manually
• Send link: /media/docs/certification?iv_storageid=xxx

🔐 Security & Privacy

Security Best Practices

1. API Keys: Store in n8n credentials (encrypted)
2. HTTPS Only: Always use HTTPS PhotoCertif URLs
3. Scope Limitation: Only grant necessary scopes
4. Key Rotation: Regenerate keys periodically
5. Test Environment: Use test keys for development

🇪🇺 GDPR Compliance

CHECKHC is fully compliant with EU General Data Protection Regulation (GDPR):

Data Processing:

• ✅ Data Minimization - Only necessary data is collected
• ✅ Purpose Limitation - Data used only for certification purposes
• ✅ Encryption - All data encrypted in transit (HTTPS) and at rest
• ✅ Right to Access - Users can download their certification data anytime
• ✅ Right to Erasure - Account deletion removes personal data (blockchain records are pseudonymized)

Privacy by Design:

• ✅ No Tracking - No analytics cookies or user tracking
• ✅ Pseudonymization - Blockchain addresses don't contain personal data
• ✅ Data Portability - Export all certification metadata in JSON format
• ✅ Transparent Processing - Clear documentation of data flows

Legal Basis:

• Contract Performance (certification services)
• Legitimate Interest (fraud prevention, service improvement)
• Consent (optional newsletter, marketing)

Data Protection Officer:

For GDPR inquiries: privacy@checkhc.net

📄 Privacy Policy | 📄 Terms of Service

📖 Additional Resources

• 🌐 Official Website: https://www.checkhc.net
• 📦 App Platform: https://app2.photocertif.com
• n8n Docs: https://docs.n8n.io
• GitHub: https://github.com/checkhc/n8n-nodes-photocertif

🤝 Support

• Discord Channel (Primary): https://discord.com/channels/1324516144979382335/1429512698504151200
  • Real-time community support
  • Direct access to developers
  • Share workflows and tips
• GitHub Issues: https://github.com/checkhc/n8n-nodes-photocertif/issues
• PhotoCertif Support: support@photocertif.com
• n8n Community: https://community.n8n.io

📄 License

MIT License - See LICENSE file for details

🏢 About CHECKHC

CHECKHC is a pioneering Web3 ecosystem for digital content certification and authentication.

Our Solutions:

• 🎨 PhotoCertif - Image & Art Certification with AI Authentication
• 📄 DigiCryptoStore - Document Certification with Secure Blockchain Storage
• 🪙 CHECKHC Token - Native utility token on Solana blockchain
• 🔗 Blockchain Integration - Solana + Secure Decentralized Storage
• 🤖 AI-Powered - Advanced detection for authenticity verification

Why Choose CHECKHC?

• ✅ Flexible Storage - Permanent (for monetization) or Erasable (GDPR-compliant)
• ✅ Blockchain Proof - Immutable NFT certificates on Solana
• ✅ AI Authentication - Advanced AI detection (4 levels)
• ✅ Full Automation - Zero manual intervention with n8n
• ✅ Enterprise Ready - High-volume B2B workflows
• ✅ GDPR Compliant - EU data protection regulation compliant
• ✅ Open Source - Transparent & community-driven

🚀 Get Started:

1. Explore: Visit www.checkhc.net
2. Try it: Sign up at app2.photocertif.com
3. Get CHECKHC Tokens: Buy on Jupiter
4. Automate: Install this n8n node for B2B workflows
5. Join Community: Discord Channel

💼 Enterprise Solutions:

Looking for custom integration or high-volume licensing?

📧 Contact: contact@checkhc.net
🌐 Official Website: www.checkhc.net ⭐

🎉 Credits

Built with ❤️ by the CHECKHC team for the Web3 certification ecosystem.

📖 Documentation

• QUICK_START.md - 5-minute setup guide
• URL_SUPPORT_GUIDE.md ⭐ NEW - Upload files from Google Drive, Dropbox, URLs
• SOLANA_WALLET_SETUP.md - Solana Wallet configuration
• AUTOMATED_B2B_GUIDE.md - Complete B2B automation guide
• N8N_INTEGRATION_GUIDE.md - Technical integration documentation
• CHANGELOG_V2.md - What's new in v2.0

🎯 Complete Workflow Example

Automated Document Certification with CHECKHC Payment

Workflow: PhotoCertif + SolanaSwap Integration
==============================================

Trigger: Webhook or Schedule
    ↓
[1] PhotoCertif: Upload
    - Operation: upload
    - Input Type: url
    - File URL: {{ $json.fileUrl }}
    - Title: {{ $json.title }}
    Output: { storageId, price_checkhc }
    ↓
[2] SolanaNode: Get Token Balance
    - Operation: getTokenBalance  
    - Token Mint: {{ $node["PhotoCertif"].json.checkhc_mint }}
    - Wallet: (from Solana API credential)
    Output: { balance }
    ↓
[3] IF Node: balance >= price_checkhc?
    ↓ YES                          ↓ NO
    [Skip to Step 5]               [4] SolanaNode: Execute Swap
                                      - Operation: executeSwapAdvanced
                                      - From: SOL
                                      - To: CHECKHC
                                      - Amount: {{ price_checkhc }}
                                      Output: { swapTx }
    ↓
[5] SolanaNode: Send Token
    - Operation: sendToken
    - Token Mint: {{ $node["PhotoCertif"].json.checkhc_mint }}
    - Recipient: {{ $node["PhotoCertif"].json.payment_wallet }}
    - Amount: {{ $node["PhotoCertif"].json.price_checkhc }}
    Output: { signature }
    ↓
[6] Wait 5 seconds (for blockchain confirmation)
    ↓
[7] PhotoCertif: Certify
    - Operation: certify
    - Storage ID: {{ $node["PhotoCertif"].json.storageId }}
    - Name: {{ $json.name }}
    - Symbol: {{ $json.symbol }}
    - Description: {{ $json.description }}
    Output: { certification_id }
    ↓
[8] PhotoCertif: Wait For Certification
    - Operation: waitForCertification
    - Storage ID: {{ $node["PhotoCertif Certify"].json.storageId }}
    - Polling Interval: 300 (5 minutes)
    - Max Wait: 3600 (1 hour)
    Output: { status: "certified", nft_mint, metadata }
    ↓
[9] Success Notification
    - Email/Slack/Discord notification
    - Data: NFT Mint, Certification URL, etc.

Key Benefits of This Architecture:

✅ Composable: Mix PhotoCertif with any n8n node ✅ Flexible: User can customize payment logic, add conditions, notifications ✅ Reusable: Solana API credential used across multiple operations ✅ Self-Contained: All necessary credentials included in the package ✅ Scalable: Easy to add batch processing, error handling, retries

Version: 1.1.0
Last Updated: 2025-10-10

🆕 What's New in v2.1

URL Upload Support

• Upload files directly from URLs (Google Drive, Dropbox, CDN)
• No more manual base64 encoding required
• Automatic content-type detection and conversion

Complete Social Links

• All 8 optional social link fields now included in workflows
• Twitter/X, Discord, Instagram, Telegram, Medium, Wiki, YouTube
• Full NFT metadata support

Batch Certification Ready ⭐

• Professional XLSX template with examples (photocertif-batch-example.xlsx)
• 3 complete examples + 6 empty rows ready to fill
• Instructions tab included in Excel file
• Perfect for Google Sheets integration

See URL_SUPPORT_GUIDE.md and BATCH_CERTIFICATION_GUIDE.md for complete documentation.

🚧 Features In Development

C2PA Content Authenticity (Status: Dev)

• Integration of Coalition for Content Provenance and Authenticity (C2PA) standard
• Cryptographic content credentials embedded in certified media
• Tamper-evident provenance tracking
• Industry-standard verification for content authenticity
• Expected: Future release