I. Introduction
As HyperBEAM infrastructure matures, developers need tools that simplify how apps are built, connected, and composed. That’s where @permaweb/libs comes in.
This SDK powers applications with libraries to interact with the permaweb. Instead of rewriting complex logic or creating incompatible tooling, builders can focus on their product and plug directly into Arweave and AO. If you’re building on the permaweb, this is a toolkit you should know.
II. What is permaweb-libs
@permaweb/libs is a developer SDK that provides modular, reusable tools for building apps on the permaweb. It abstracts away complexity while exposing composable building blocks.
Key modules include:
- Profiles – Create and manage user identities across applications
- Atomic Assets – Mint and interact with AO-native digital assets
- Comments – Enable social features across apps
- Collections – Group and organize digital assets like atomic assets
- Zones – Represent programmable entities such as user profiles, organizations, or channels
All modules are designed to work together. Developers can build on top of AO and Arweave without writing custom integrations from scratch.
III. Why it matters
Web3 often promises composability but rarely delivers it. For an emerging ecosystem like the permaweb, standardization is critical. Without shared protocols for interaction, the permaweb risks becoming another fragmented environment like Web2.
permaweb-libs addresses this by standardizing common interactions and enabling true interoperability between apps. Profiles and assets created in one interface can be accessed and extended in another.
It also provides a helpful on-ramp for new developers learning to build on the permaweb. Rather than starting from zero, they can build faster with composable primitives and documented patterns.
IV. Decentralized Media Ecosystem (DME)
A key long-term vision for the permaweb is to support decentralized media at scale. With permanent storage from Arweave and decentralized compute from AO, developers can create platforms where media, identity, and logic are interoperable.
The concept of a Decentralized Media Ecosystem (DME), introduced by the Odysee team, outlines the following vision:
- Unlimited media apps powered by Arweave, focused on privacy and censorship resistance
- Launch-ready infrastructure with shared access to all content in the ecosystem
- The freedom for users to build and customize their own interfaces
- Creators no longer dependent on migrating audiences between platforms
- No single point of failure. If one app goes offline, the data and identity remain intact
- Content is openly distributable within ecosystem applications that respect the creator’s terms. See more about UDL.
This vision is only possible if apps use shared tooling and standards. permaweb-libs is a major step toward realizing that future. Read the full Odysee DME blog here.
V. Projects using permaweb-libs
One of the most recent integrations comes from Beacon Wallet.
Beacon now uses permaweb-libs to give users:
- A mobile UI to access Bazar
- Support for uploading atomic assets
- Direct access to permaweb profiles from the wallet interface
This is composability in action. Beacon plugged into existing protocols and shipped meaningful features without rebuilding core infrastructure.
Other examples include:
- LiquidOps – DeFi app using permaweb profiles.
- Llamaland and ArcAO – Games leveraging permaweb-native identities and assets
Whether you’re building marketplaces, dashboards, or social apps, this SDK gives you a clean, composable foundation.
VI. Conclusion
Permaweb-libs is a toolkit for building the next generation of permanent, decentralized applications. This SDK makes it possible to build a decentralized media ecosystem.
As the ecosystem grows, it’s essential that developers adopt shared tools and composable standards. This ensures apps can integrate seamlessly and users can move freely across the ecosystem.
Check out the repo here: https://github.com/permaweb/permaweb-libs
Installation Prerequisites
- node >= v18.0
- npm or yarn
- arweave
- @permaweb/aoconnect
Installation
If arweave or @permaweb/aoconnect is not already installed, add them to the installation command below:
npm install @permaweb/libs
or
yarn add @permaweb/libs
Questions or feedback
Permaweb-libs is maintained by the Forward Research and Odysee teams. It will continue to evolve as ecosystem needs grow.
If you’d like to contribute, open an issue in the GitHub repo.
If you’re integrating the SDK and run into issues, join the Bazar Discord and open a support ticket. The Bazar team are early adopters and can guide you through implementation.