SDK reference
SDK source for nine runtimes, with separate browser, server and native responsibilities. Source implementation, public distribution, device testing and live eligibility are different evidence levels. Check each runtime before integrating.
See the reviewed capability matrix for publication evidence, ad formats and production limitations.
| Platform | Package | Language | Status and distribution | |
|---|---|---|---|---|
| Web (Browser) | @theaimart/adx-web | TypeScript | Experimental · Source only; public installation not verified | Docs |
| Node.js (server) | @theaimart/adx | TypeScript | Experimental · Public package 1.0.0 verified; runtime eligibility pending | Docs |
| Python | theaimart-adx | Python 3.8+ | Experimental · Public package 1.0.0 verified; runtime eligibility pending | Docs |
| Rust (server) | theaimart-adx | Rust | Experimental · Public package 1.0.0 verified; runtime eligibility pending | Docs |
| React Native | @theaimart/adx-react-native | TypeScript | Experimental · Source only; public installation not verified | Docs |
| Android (Kotlin) | co.theaimart:adx-android | Kotlin | Experimental · Source only; public installation not verified | Docs |
| iOS (Swift) | TheaimartAdx | Swift | Experimental · Source only; public installation not verified | Docs |
| Flutter (Dart) | theaimart_adx | Dart | Experimental · Public package 1.0.0 verified; runtime eligibility pending | Docs |
| Unity (C#) | co.theaimart.adx | C# | Experimental · Source only; public installation not verified | Docs |
Legacy web tags
Prefer zero-build drop-in tags over the npm package?adx.js and the low-bandwidth adx-lite.js serve the same contract as a plain <script> include — see the developer overview for those snippets.Shared contract and runtime limits
The SDK sources reference the same wire contract, but runtime rendering and installation requirements differ:
- Identical
filled/kind/source/isTrackablenormalized result shape. - WAF-safe encoding of every free-text parameter.
- A platform-tagged, fraud-safe User-Agent by default.
- Handle no-fill safely. SDK error behavior differs; check the selected runtime and its tests.
- Custom renderers must enforce creative isolation — see the security model.
Which SDK do I need?
- Website — Web (source build; npm publication unverified) or the drop-in
adx.jstag. - Server-rendered pages / server-to-server — Node, Python or Rust.
- Cross-platform app — React Native or Flutter.
- Native app — Android or iOS.
- Game — Unity.
- Already on Prebid / another exchange — review the OpenRTB source contract and request an approved connection. A certified Prebid adapter and active partner demand are not established.