Complete Near Intents Tracker

[premiumjibles]

Context

The ShapeShift affiliate revenue API aggregates fee data from multiple swap providers. Near Intents is a cross-chain swap provider that ShapeShift integrates with. A tracker file exists but has incomplete implementation with TODO comments that need to be resolved.

Current Problem: The Near Intents tracker (nearIntents.ts) has placeholder code and TODO comments for:

1. Parsing asset IDs from the API response
2. Determining which transaction hash to use

Current Implementation

Location: node/proxy/api/src/affiliateRevenue/nearIntents.ts

The file exists but has incomplete sections around lines 66-73:

// TODO: Figure out parsing of originAsset/destinationAsset
const chainId = ''
const assetId = `${chainId}/`

// TODO: determine if origin or destination chain tx hash...
txHash: '',

Acceptance Criteria

• Review the Near Intents API response structure
• Implement proper parsing of originAsset and destinationAsset to extract chainId and assetId
• Determine appropriate txHash to use (origin or destination chain)
• Ensure NEAR_INTENTS_API_KEY environment variable is documented
• Verify tracker returns valid data with real API calls
• Ensure 'nearintents' is in the services array in models.ts

Files to Modify

• node/proxy/api/src/affiliateRevenue/nearIntents.ts
• node/proxy/api/src/models.ts (verify service is listed)
• node/proxy/sample.env (document the API key)

Reference

The main ShapeShift app has a Near Intents swapper integration that may provide insight into the API response format:

• Path: packages/swapper/src/swappers/NearIntentsSwapper/ (in the shapeshift/web repo)

Environment Variables

• NEAR_INTENTS_API_KEY - Required for API authentication (needs to be added to CircleCI for deployment)

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

_{You can configure auto-planning by selecting labels in the issue_enrichment configuration.}

🔗 Related PRs

shapeshift/web#11016 - feat: near intents swapper [merged]
shapeshift/web#11043 - feat: near intents NEP-245 support [merged]
shapeshift/web#11097 - feat: near intents unsupported trade pair error handling [merged]
shapeshift/web#11164 - feat: near affiliate fees [merged]
#1228 - feat: affiliate revenue tracker and endpoint [closed]

👤 Suggested Assignees

• gomesalexandre
• kaladinlight

---

🧪 Issue enrichment is currently in open beta.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord or schedule a call!

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

---

🔗 Similar Issues

Possible Duplicates

• https://github.com/shapeshift/web/issues/11436

Related Issues

• https://github.com/shapeshift/web/issues/11462
• Complete Near Intents Tracker #1235

🔗 Related PRs

shapeshift/web#11016 - feat: near intents swapper [merged]
shapeshift/web#11043 - feat: near intents NEP-245 support [merged]
shapeshift/web#11097 - feat: near intents unsupported trade pair error handling [merged]
shapeshift/web#11164 - feat: near affiliate fees [merged]
#1228 - feat: affiliate revenue tracker and endpoint [merged]

👤 Suggested Assignees

• gomesalexandre
• premiumjibles
• kaladinlight

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord or schedule a call!