OpenTelemetry-compatible instrumentation hooks

[truthixify]

Tier: M (2-4 days) | Type: feature

Context. Production users running the SDK inside a Node service (indexers, notification workers) want spans on scan, decrypt, RPC calls, and key derivation without patching internals. Ship a minimal pluggable tracer interface so an app can adapt any tracer (OpenTelemetry, Sentry, Datadog) without the SDK depending on any of them.

Scope.

• Tracer interface: startSpan(name, attrs?): Span; Span has setAttribute, recordException, end.
• Global setTracer(tracer) in src/index.ts plus per-call tracer override.
• Instrument the hot paths: stellar scan pipeline, RPC client, key derivation, agent tool calls.
• Ship a tiny @opentelemetry/api example adapter under examples/otel/.

Acceptance.

• Zero-tracer default is a no-op with negligible overhead (bench)
• Example adapter emits spans covering an end-to-end scan
• Spans carry stable attribute names documented in docs/observability.md (new)
• No new runtime dep on @opentelemetry/*

Files. src/telemetry.ts (new), src/chains/stellar/scan.ts, src/chains/stellar/rpc.ts, src/agent/tools.ts, docs/observability.md (new), examples/otel/ (new).

[lamborghini21]

@lamborghini21 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello boss, I'd love to work on this issue and I promise to deliver results in 24 hours.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @lamborghini21 to this issue.

[helenahelenavanbeek-png]

@helenahelenavanbeek-png has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I’m a full-stack software developer experienced in both enterprise applications and Web3 projects, with four hackathon wins and hands-on work across frontend, backend, APIs, databases, and blockchain integrations. I will first review the issue and existing codebase, then implement a clean, well-tested solution and submit a clear PR within the agreed timeline. Kindly assign.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @helenahelenavanbeek-png to this issue.

[annacodervibe]

@annacodervibe has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I would love to work on this issue, already reviewed the description and have experience with it , please assign me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @annacodervibe to this issue.

[Meme11030]

@Meme11030 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi maintainer I will like to work on this issue please

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Meme11030 to this issue.

[nurudeenheroic]

@nurudeenheroic has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Please assign the issue to me. I’m ready to work on it.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @nurudeenheroic to this issue.