bitburner-src/markdown/bitburner.singularity.purchaseprogram.md
Olivier Gagnon 8b69fd7faa doc
2022-01-15 18:39:37 -05:00

49 lines
1.1 KiB
Markdown

<!-- Do not edit this file. It is automatically generated by API Documenter. -->
[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [Singularity](./bitburner.singularity.md) &gt; [purchaseProgram](./bitburner.singularity.purchaseprogram.md)
## Singularity.purchaseProgram() method
Purchase a program from the dark web.
<b>Signature:</b>
```typescript
purchaseProgram(programName: string): boolean;
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
| programName | string | Name of program to purchase. |
<b>Returns:</b>
boolean
True if the specified program is purchased, and false otherwise.
## Remarks
RAM cost: 2 GB \* 16/4/1
This function allows you to automatically purchase programs. You MUST have a TOR router in order to use this function. The cost of purchasing programs using this function is the same as if you were purchasing them through the Dark Web using the Terminal buy command.
## Example 1
```ts
// NS1
purchaseProgram("brutessh.exe");
```
## Example 2
```ts
// NS2
ns.purchaseProgram("brutessh.exe");
```