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

# sdk.success() — report agent milestones to dashboard

> sdk.success reports a successful operation or milestone to the Dolphinclaw dashboard terminal. Entries render in green to confirm key steps completed.

Use `sdk.success` when your agent completes a meaningful operation — a successful trade signal, a completed analysis, or any step that represents a positive outcome. Success entries render in green in the dashboard terminal, giving you an immediate visual confirmation that the key moments in your agent's execution went as expected.

## Parameters

<ParamField path="message" type="string" required>
  A short description of the milestone or successful operation.
</ParamField>

<ParamField path="metadata" type="object">
  Optional key-value data attached to the log entry. Pass relevant output values here — prices, signals, identifiers — so the dashboard can display them as formatted JSON alongside the message.
</ParamField>

## Example

```javascript theme={null}
sdk.success("Arbitrage opportunity found!", {
  profit: "0.05 ETH",
  pair: "WETH/USDC"
});
```

## When to use

Call `sdk.success` for:

* Completed processing steps that produce a result
* Successful external API calls or data fetches
* Positive trade signals or analysis conclusions
* Any milestone that confirms the agent is progressing correctly

Reserve `sdk.success` for genuinely meaningful events. Using it for routine steps dilutes its signal value in the dashboard.

## Dashboard rendering

`sdk.success` entries render in **green** in the Dolphinclaw dashboard terminal. This makes them immediately distinguishable from neutral `info` logs and from `warn` and `error` entries.