# spark\_flashnet\_clawbackFunds

Use the `spark_flashnet_clawbackFunds` method to let users recover funds that were sent to a Flashnet LP wallet but weren’t properly processed.\
This is a safety mechanism for reclaiming **stuck transfers** within a 23-hour window.

The wallet validates eligibility, signs the request, and submits it to Flashnet.

***

## Example

```ts
import { request } from "sats-connect";

try {
  const response = await request("spark_flashnet_clawbackFunds", {
    senderPublicKey: "02abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567",
    sparkTransferId: "550e8400-e29b-41d4-a716-446655440000",
    lpIdentityPublicKey: "03aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
    nonce: "clawback-nonce-123456"
  });

  if ("result" in response) {
    console.log("Clawback result:", response.result);
  } else {
    console.error("Clawback failed:", response.error.message);
  }
} catch (error) {
  console.error("Unexpected error:", error);
}
```

***

## Parameters

* **`sparkTransferId`** *(string, required)* — Spark transfer ID of the stuck payment.
* **`lpIdentityPublicKey`** *(string, required)* — LP wallet identity public key that received the funds.

***

## What it does

When called, the wallet:

1. Displays a **review screen** summarizing the clawback request.
2. On approval, validates eligibility (time window, valid LP wallet, sender ownership).
3. Signs and submits the clawback to Flashnet.
4. Returns tracking information for the refund process.

***

## Response

The method returns a Promise resolving to a `SparkFlashnetClawbackResult`.

### **✅ Success**

```json
{
  "accepted": true,
  "requestId": "01HJZKFABCDEFGHJKLMNPQRSTVW",
  "internalRequestId": "settlement-internal-123",
  "sparkStatusTrackingId": "spark-track-456"
}
```

### **❌ Failure**

```json
{
  "accepted": false,
  "error": "Transfer is too old for clawback",
  "requestId": "01HJZKFABCDEFGHJKLMNPQRSTVW"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xverse.app/sats-connect/spark-methods/flashnet-trading/spark_flashnet_clawbackfunds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.