NEARIntentsAdapter

SIP Protocol API Reference / NEARIntentsAdapter

Class: NEARIntentsAdapter

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1783

NEAR Intents Adapter

Provides privacy-preserving cross-chain swaps via NEAR 1Click API.

Example

const adapter = new NEARIntentsAdapter({
  jwtToken: process.env.NEAR_INTENTS_JWT,
})

// Or with custom asset mappings (e.g., testnet)
const testnetAdapter = new NEARIntentsAdapter({
  jwtToken: process.env.NEAR_INTENTS_JWT,
  assetMappings: {
    'near:testUSDC': 'near:testnet:usdc.test',
  },
})

// Prepare a swap with stealth recipient
const prepared = await adapter.prepareSwap(intent, recipientMetaAddress)

// Get quote
const quote = await adapter.getQuote(prepared)

// Execute (after depositing to depositAddress)
const result = await adapter.trackSwap(quote.depositAddress)

Constructors

Constructor

new NEARIntentsAdapter(config?): NEARIntentsAdapter

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1788

Parameters

config?

NEARIntentsAdapterConfig

Returns

NEARIntentsAdapter

Methods

getClient()

getClient(): OneClickClient

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1792

Get the underlying OneClick client

Returns

OneClickClient

prepareSwap()

prepareSwap(request, recipientMetaAddress?, senderAddress?, transparentRecipient?): Promise<PreparedSwap>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1804

Prepare a swap request

For shielded/compliant modes, generates a stealth address for the recipient.

Parameters

request

SwapRequest

Swap request parameters

recipientMetaAddress?

Recipient’s stealth meta-address (for privacy modes)

string | StealthMetaAddress

senderAddress?

string

Sender’s address for refunds

transparentRecipient?

string

Explicit recipient address for transparent mode (defaults to senderAddress)

Returns

Promise<PreparedSwap>

Prepared swap with quote request

getQuote()

getQuote(prepared): Promise<OneClickQuoteResponse>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1811

Get a quote for a prepared swap

Parameters

prepared

PreparedSwap

Prepared swap from prepareSwap()

Returns

Promise<OneClickQuoteResponse>

Quote response with deposit address

getDryQuote()

getDryQuote(prepared): Promise<OneClickQuoteResponse>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1818

Get a dry quote (preview without deposit address)

Parameters

prepared

PreparedSwap

Prepared swap

Returns

Promise<OneClickQuoteResponse>

Quote preview

notifyDeposit()

notifyDeposit(depositAddress, txHash, nearAccount?): Promise<void>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1826

Notify 1Click of deposit transaction

Parameters

depositAddress

string

Deposit address from quote

txHash

string

Deposit transaction hash

nearAccount?

string

NEAR account (if depositing from NEAR)

Returns

Promise<void>

getStatus()

getStatus(depositAddress): Promise<OneClickStatusResponse>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1833

Get current swap status

Parameters

depositAddress

string

Deposit address from quote

Returns

Promise<OneClickStatusResponse>

Current status

waitForCompletion()

waitForCompletion(depositAddress, options?): Promise<OneClickStatusResponse>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1841

Wait for swap to complete

Parameters

depositAddress

string

Deposit address from quote

options?

Polling options

interval?

number

timeout?

number

onStatus?

(status) => void

Returns

Promise<OneClickStatusResponse>

Final status

initiateSwap()

initiateSwap(request, recipientMetaAddress?, senderAddress?): Promise<SwapResult>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1859

Execute a full swap flow

This is a convenience method that:

Prepares the swap with stealth address
Gets a quote
Returns all info needed for the user to deposit

Parameters

request

SwapRequest

Swap request parameters

recipientMetaAddress?

Recipient’s stealth meta-address

string | StealthMetaAddress

senderAddress?

string

Sender’s address for refunds

Returns

Promise<SwapResult>

Swap result with deposit instructions

mapAsset()

mapAsset(chain, symbol): string

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1863

Convert SIP asset to Defuse asset identifier

Parameters

chain

ChainId

symbol

string

Returns

string

mapChainType()

mapChainType(chain): string

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1868

Convert SIP chain ID to blockchain type

Parameters

chain

ChainId

Returns

string

Deprecated

Use getBlockchainType() instead. The 1Click API now uses ORIGIN_CHAIN/DESTINATION_CHAIN types.

getBlockchainType()

getBlockchainType(chain): string

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:1874

Get blockchain type for a chain (for address format validation)

Parameters

chain

ChainId

Returns

string