# gamba

Latest version **0.8.7** (published 2023-09-22) · 0 weekly downloads

## Install

```sh
npm install gamba
pnpm add gamba
yarn add gamba
bun add gamba
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.8.7 |
| Published | 2023-09-22 |
| First published | 2023-03-12 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 8.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | shrimpman |

## Links

- npm: https://www.npmjs.com/package/gamba
- npm.io page: https://npm.io/package/gamba

## Dependencies (3)

- [gamba-core](https://npm.io/package/gamba-core.md) 0.5.5
- [gamba-react](https://npm.io/package/gamba-react.md) 0.3.7
- [gamba-react-ui](https://npm.io/package/gamba-react-ui.md) 0.4.5

## Recent versions

- 0.8.7 (latest) — 2023-09-22
- 0.8.6 — 2023-09-20
- 0.8.5 — 2023-09-19
- 0.8.4 — 2023-09-19
- 0.8.3 — 2023-09-16
- 0.8.1 — 2023-09-15
- 0.8.0 — 2023-09-15
- 0.7.4 — 2023-07-21
- 0.7.3 — 2023-07-17
- 0.7.2 — 2023-07-17
- 0.7.1 — 2023-07-15
- 0.7.0 — 2023-07-15
- 0.6.8 — 2023-06-21
- 0.6.7 — 2023-06-21
- 0.6.6 — 2023-06-16
- … 16 more at https://npm.io/package/gamba/versions

## README

<a href="https://gamba.so">
  <img src="https://github.com/gamba-labs/gamba/assets/127314884/fd1227f8-8b63-4515-94fd-6ea1625e8083" alt="Gamba Banner" />
</a>

<div align="center">

[![npm version](https://img.shields.io/npm/v/gamba.svg?color=orange)](https://www.npmjs.com/package/gamba) [![npm downloads](https://img.shields.io/npm/dt/gamba.svg?color=orange)](https://www.npmjs.com/package/gamba)

<h3>Create betting games on Solana with zero deployments ✨</h3><hr />

<table>
    <tbody>
      <tr>
        <td>
          <a href="https://gamba.so">📝 Documentation</a>
        </td>
        <td>
          <a href="https://discord.com/invite/xjBsW3e8fK">💬 Discord</a>
        </td>
        <td>
          <a href="https://twitter.com/gambalabs">🐦 Twitter</a>
        </td>
      </tr>
    </tbody>
  </table>
</div>

# Gamba

Gamba is a decentralized betting platform on Solana. It handles all liquidity and randomness, allowing developers to focus on building games.

When users play on your app you will automatically collect royaltees.

[Learn more](https://gamba.so)

## Installation

If you want to create a Gamba project from scratch you can install our main package:

`npm i gamba`

## Example

The following example is a simple game where the user has a 50/50 chance of doubling their money.

```jsx
import React from 'react'
import { Gamba, useGamba } from 'gamba/react'

function DoubleOrNothing() {
  const gamba = useGamba()

  const play = async () => {
    // Request user to sign transaction
    const request = await gamba.play({
      bet: [0, 2], // 0x or 2x
      wager: 1e9 * 0.1, // 0.1 SOL
    })
    // Await the result
    const result = await request.result()
    // ... Visualize the result however you want
  }

  return (
    <>
      <button onClick={play}>
        Double or Nothing
      </button>
      {gamba.user.balance > 0 && (
        <button onClick={() => gamba.withdraw()}>
          Claim {gamba.user.balance / 1e9} SOL
        </button>
      )}
    </>
  )
}

function App() {
  return (
    <Gamba creator="<PUBLIC KEY>">
      <DoubleOrNothing />
    </Gamba>
  )
}
```

## Packages

`gamba` contains all the individual packages listed below. In most cases this is the only library you need to install.

## Nested packages:

The packages listed here are already included in the main `gamba` package, but can also be installed independently if needed. They are reachable under `gamba/<package>`.

* [`gamba-core`](https://github.com/gamba-labs/gamba/tree/main/packages/gamba-core) contains the essential stuff and works in other environment such as NodeJS

* [`gamba-react`](https://github.com/gamba-labs/gamba/tree/main/packages/gamba-react) contains everything related to React such as context providers and hooks.

* [`gamba-react-ui`](https://github.com/gamba-labs/gamba/tree/main/packages/gamba-react-ui) contains useful components and utilities for building games in your platform.

## Documentation

Read our WIP documentation at [gamba.so](https://gamba.so/docs), or ask away in [Discord](https://discord.com/invite/xjBsW3e8fK)

---
_Source: https://npm.io/package/gamba · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._