> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.nexbridge.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Funding Lifecycle

# Funding Lifecycle

Funding activity represents operational funding received and tracked through the Partner API lifecycle.

Funding activity is associated with:

* requests
* balances
* settlement eligibility

A single funding event may:

* fund multiple requests
* be partially allocated
* remain partially available

***

# Funding Lifecycle States

## RECEIVED

Funding was detected successfully.

Operational validation may still be pending.

***

## DIRTY

Funding originated from a non-approved source.

Dirty funding is operationally segregated and cannot participate in settlement or allocation.

***

## ELIGIBLE

Funding passed operational validation and may participate in request allocation.

Eligible funding may be:

* fully available
* partially allocated
* fully allocated

***

## ALLOCATED

Funding was partially or fully assigned to operational requests.

Allocated funding remains linked to the associated requests until settlement completion.

***

## CONSUMED

Funding was fully utilized through completed settlement flows.

Consumed funding is no longer available operationally.

***

# Funding Validation

Funding validation verifies:

* supported asset
* supported network
* operational compatibility
* approved funding source

Funding failing operational validation transitions to:

```text theme={null}
DIRTY
```

***

# Approved Funding Sources

Only approved funding sources are eligible for allocation.

Funding received from non-approved sources:

* remains visible operationally
* is excluded from settlement flows
* cannot participate in request matching

***

# Partial Funding Support

Requests support partial funding.

As a result:

* multiple funding events may contribute to one request
* one funding event may contribute to multiple requests

***

# Allocation Rules

Allocation occurs only after funding becomes:

```text theme={null}
ELIGIBLE
```

Funding allocation depends on:

* request lifecycle
* available balances
* operational settlement requirements

***

# Balance Visibility

Funding contributes to:

* available balances
* allocated balances
* dirty balances

depending on lifecycle state.

***

# Operational Visibility

Partners may retrieve:

* funding lifecycle states
* linked requests
* balance visibility
* operational allocation status

through the Partner API.

***

# Precision Rules

| Asset | Precision        |
| ----- | ---------------- |
| USTBL | Up to 6 decimals |
| USDT  | Up to 2 decimals |

***

# Error Scenarios

Funding may fail operational validation for reasons including:

* unsupported asset
* unsupported network
* invalid funding source
* operational restrictions
* incompatible request lifecycle

***

# Future Scope

The following capabilities are currently out of scope for V1:

* manual funding reassignment
* partner-controlled allocation
* funding cancellation
* funding amendments
* webhook notifications
* advanced treasury visibility